feat(streaming): decoded per-frame sample pipeline — raise per-channel SampleReceived from the live stream (#242)

src/Daqifi.Core.Tests/Channel/AnalogChannelTests.cs

@@ -139,6 +139,39 @@ public void SetActiveSample_RaisesSampleReceivedEvent()
         Assert.Equal(timestamp, receivedSample.Timestamp);
     }
 
+    [Fact]
+    public void SetActiveSample_EventArgsCarryRaisingChannel()
+    {
+        // Arrange
+        var channel = new AnalogChannel(3);
+        IChannel? eventChannel = null;
+        channel.SampleReceived += (_, args) => eventChannel = args.Channel;
+
+        // Act
+        channel.SetActiveSample(1.0, DateTime.UtcNow);
+
+        // Assert
+        Assert.Same(channel, eventChannel);
+    }
+
+    [Fact]
+    public void SetActiveSample_WithFullSample_PreservesRawValueAndDeviceTimestamp()
+    {
+        // Arrange
+        var channel = new AnalogChannel(0);
+        IDataSample? received = null;
+        channel.SampleReceived += (_, args) => received = args.Sample;
+        var sample = new DataSample(DateTime.UtcNow, 2.5, rawValue: 128, deviceTimestamp: 555u);
+
+        // Act
+        channel.SetActiveSample(sample);
+
+        // Assert
+        Assert.Same(sample, channel.ActiveSample);
+        Assert.Equal(128, received!.RawValue);
+        Assert.Equal(555u, received.DeviceTimestamp);
+    }
+
     [Fact]
     public async Task SetActiveSample_IsThreadSafe()
     {

src/Daqifi.Core.Tests/Channel/DataSampleTests.cs

@@ -30,6 +30,29 @@ public void Constructor_WithParameters_SetsProvidedValues()
         Assert.Equal(value, sample.Value);
     }
 
+    [Fact]
+    public void Constructor_WithNoDecodeMetadata_DefaultsRawValueAndDeviceTimestamp()
+    {
+        // Samples not produced by the decode pipeline have no raw value or device timestamp.
+        var sample = new DataSample(DateTime.UtcNow, 1.0);
+
+        Assert.Null(sample.RawValue);
+        Assert.Null(sample.DeviceTimestamp);
+    }
+
+    [Fact]
+    public void Constructor_WithDecodeMetadata_SetsRawValueAndDeviceTimestamp()
+    {
+        var timestamp = new DateTime(2025, 10, 20, 12, 0, 0, DateTimeKind.Utc);
+
+        var sample = new DataSample(timestamp, 1.25, rawValue: 4321, deviceTimestamp: 987654u);
+
+        Assert.Equal(timestamp, sample.Timestamp);
+        Assert.Equal(1.25, sample.Value);
+        Assert.Equal(4321, sample.RawValue);
+        Assert.Equal(987654u, sample.DeviceTimestamp);
+    }
+
     [Fact]
     public void Value_CanBeModified()
     {