feat(models): add Truncated flag to Line

diomonogatari · diomonogatari · commit fc9aa2cb0f1e · 2026-06-05T19:34:20.000+01:00
Bitbucket sets "truncated": true on file lines that exceed the server's maximum line length when browsing a repository path; the Line model dropped the field, silently losing that signal. Add bool? Truncated so callers can detect truncated content. Implements lvermeulen#30.
diff --git a/src/Bitbucket.Net/Models/Core/Projects/Line.cs b/src/Bitbucket.Net/Models/Core/Projects/Line.cs
@@ -1,6 +1,19 @@
 namespace Bitbucket.Net.Models.Core.Projects;
 
+/// <summary>
+/// A single line of file content returned when browsing a repository path.
+/// </summary>
 public class Line
 {
+    /// <summary>
+    /// The text of the line.
+    /// </summary>
     public string? Text { get; init; }
+
+    /// <summary>
+    /// <see langword="true"/> when Bitbucket truncated this line because it exceeded the server's
+    /// maximum line length; otherwise <see langword="false"/> or <see langword="null"/> when the
+    /// server does not report truncation.
+    /// </summary>
+    public bool? Truncated { get; init; }
 }
diff --git a/test/Bitbucket.Net.Tests/UnitTests/ModelSerializationTests.cs b/test/Bitbucket.Net.Tests/UnitTests/ModelSerializationTests.cs
@@ -12,6 +12,72 @@ namespace Bitbucket.Net.Tests.UnitTests;
 
 public class ModelSerializationTests
 {
+    #region Line Serialization Tests
+
+    [Fact]
+    public void Line_Deserialization_ReadsTruncatedFlag()
+    {
+        var json = """
+        {
+            "text": "a very long line that the server truncated",
+            "truncated": true
+        }
+        """;
+
+        var line = JsonSerializer.Deserialize(json, BitbucketJsonContext.Default.Line);
+
+        Assert.NotNull(line);
+        Assert.Equal("a very long line that the server truncated", line.Text);
+        Assert.True(line.Truncated);
+    }
+
+    [Fact]
+    public void Line_Deserialization_TruncatedNullWhenAbsent()
+    {
+        var json = """
+        {
+            "text": "short line"
+        }
+        """;
+
+        var line = JsonSerializer.Deserialize(json, BitbucketJsonContext.Default.Line);
+
+        Assert.NotNull(line);
+        Assert.Equal("short line", line.Text);
+        Assert.Null(line.Truncated);
+    }
+
+    [Fact]
+    public void Line_Deserialization_ReadsExplicitFalse()
+    {
+        var json = """
+        {
+            "text": "untruncated line",
+            "truncated": false
+        }
+        """;
+
+        var line = JsonSerializer.Deserialize(json, BitbucketJsonContext.Default.Line);
+
+        Assert.NotNull(line);
+        Assert.False(line.Truncated);
+    }
+
+    [Fact]
+    public void Line_Serialization_RoundTrips()
+    {
+        var line = new Line { Text = "round trip", Truncated = true };
+
+        var json = JsonSerializer.Serialize(line, BitbucketJsonContext.Default.Line);
+        var deserialized = JsonSerializer.Deserialize(json, BitbucketJsonContext.Default.Line);
+
+        Assert.NotNull(deserialized);
+        Assert.Equal(line.Text, deserialized.Text);
+        Assert.Equal(line.Truncated, deserialized.Truncated);
+    }
+
+    #endregion
+
     #region Project Serialization Tests
 
     [Fact]
