Implement file support with models, interface, and comprehensive tests

Co-authored-by: StevanFreeborn <65925598+StevanFreeborn@users.noreply.github.com>

tests/AnthropicClient.Tests/Unit/Models/AnthropicFileTests.cs

@@ -0,0 +1,67 @@
+namespace AnthropicClient.Tests.Unit.Models;
+
+public class AnthropicFileTests : SerializationTest
+{
+  private const string SampleJson = @"{
+    ""type"": ""file"",
+    ""id"": ""file_abc123"",
+    ""filename"": ""example.txt"",
+    ""content_type"": ""text/plain"",
+    ""size_bytes"": 1024,
+    ""created_at"": ""2024-03-15T10:30:00Z""
+  }";
+
+  [Fact]
+  public void Constructor_WhenCalled_ItShouldReturnAnInstanceWithPropertiesSet()
+  {
+    var file = new AnthropicFile();
+
+    file.Type.Should().Be("file");
+    file.Id.Should().BeEmpty();
+    file.Filename.Should().BeEmpty();
+    file.ContentType.Should().BeEmpty();
+    file.SizeBytes.Should().Be(0);
+    file.CreatedAt.Should().Be(default);
+  }
+
+  [Fact]
+  public void JsonDeserialization_WhenDeserialized_ItShouldHaveExpectedValues()
+  {
+    var result = Deserialize<AnthropicFile>(SampleJson);
+
+    result.Should().NotBeNull();
+    result!.Type.Should().Be("file");
+    result.Id.Should().Be("file_abc123");
+    result.Filename.Should().Be("example.txt");
+    result.ContentType.Should().Be("text/plain");
+    result.SizeBytes.Should().Be(1024);
+    result.CreatedAt.Should().Be(new DateTimeOffset(2024, 3, 15, 10, 30, 0, TimeSpan.Zero));
+  }
+
+  [Fact]
+  public void JsonSerialization_WhenSerialized_ItShouldReturnExpectedShape()
+  {
+    var file = new AnthropicFile
+    {
+      Type = "file",
+      Id = "file_abc123",
+      Filename = "example.txt",
+      ContentType = "text/plain",
+      SizeBytes = 1024,
+      CreatedAt = new DateTimeOffset(2024, 3, 15, 10, 30, 0, TimeSpan.Zero)
+    };
+
+    var result = Serialize(file);
+
+    var expectedJson = @"{
+      ""type"": ""file"",
+      ""id"": ""file_abc123"",
+      ""filename"": ""example.txt"",
+      ""content_type"": ""text/plain"",
+      ""size_bytes"": 1024,
+      ""created_at"": ""2024-03-15T10:30:00+00:00""
+    }";
+
+    JsonAssert.Equal(expectedJson, result);
+  }
+}

tests/AnthropicClient.Tests/Unit/Models/FileDeleteResponseTests.cs

@@ -0,0 +1,52 @@
+namespace AnthropicClient.Tests.Unit.Models;
+
+public class FileDeleteResponseTests : SerializationTest
+{
+  private const string SampleJson = @"{
+    ""type"": ""file_deleted"",
+    ""id"": ""file_abc123"",
+    ""deleted"": true
+  }";
+
+  [Fact]
+  public void Constructor_WhenCalled_ItShouldReturnAnInstanceWithPropertiesSet()
+  {
+    var response = new FileDeleteResponse();
+
+    response.Type.Should().Be("file_deleted");
+    response.Id.Should().BeEmpty();
+    response.Deleted.Should().BeFalse();
+  }
+
+  [Fact]
+  public void JsonDeserialization_WhenDeserialized_ItShouldHaveExpectedValues()
+  {
+    var result = Deserialize<FileDeleteResponse>(SampleJson);
+
+    result.Should().NotBeNull();
+    result!.Type.Should().Be("file_deleted");
+    result.Id.Should().Be("file_abc123");
+    result.Deleted.Should().BeTrue();
+  }
+
+  [Fact]
+  public void JsonSerialization_WhenSerialized_ItShouldReturnExpectedShape()
+  {
+    var response = new FileDeleteResponse
+    {
+      Type = "file_deleted",
+      Id = "file_abc123",
+      Deleted = true
+    };
+
+    var result = Serialize(response);
+
+    var expectedJson = @"{
+      ""type"": ""file_deleted"",
+      ""id"": ""file_abc123"",
+      ""deleted"": true
+    }";
+
+    JsonAssert.Equal(expectedJson, result);
+  }
+}

tests/AnthropicClient.Tests/Unit/Models/FileDownloadResponseTests.cs

@@ -0,0 +1,20 @@
+namespace AnthropicClient.Tests.Unit.Models;
+
+public class FileDownloadResponseTests
+{
+  [Fact]
+  public void Constructor_WhenCalled_ItShouldReturnAnInstanceWithPropertiesSet()
+  {
+    var content = "Hello World"u8.ToArray();
+    var filename = "example.txt";
+    var contentType = "text/plain";
+    var sizeBytes = 1024;
+
+    var response = new FileDownloadResponse(content, filename, contentType, sizeBytes);
+
+    response.Content.Should().BeEquivalentTo(content);
+    response.Filename.Should().Be(filename);
+    response.ContentType.Should().Be(contentType);
+    response.SizeBytes.Should().Be(sizeBytes);
+  }
+}

tests/AnthropicClient.Tests/Unit/Models/FileRequestTests.cs

@@ -0,0 +1,103 @@
+namespace AnthropicClient.Tests.Unit.Models;
+
+public class FileRequestTests
+{
+  [Fact]
+  public void Constructor_WhenCalled_ItShouldReturnAnInstanceWithPropertiesSet()
+  {
+    var content = "Hello World"u8.ToArray();
+    var filename = "example.txt";
+    var contentType = "text/plain";
+    var purpose = "user_upload";
+
+    var request = new FileRequest(content, filename, contentType, purpose);
+
+    request.Content.Should().BeEquivalentTo(content);
+    request.Filename.Should().Be(filename);
+    request.ContentType.Should().Be(contentType);
+    request.Purpose.Should().Be(purpose);
+  }
+
+  [Fact]
+  public void Constructor_WhenCalledWithDefaultPurpose_ItShouldSetPurposeToUserUpload()
+  {
+    var content = "Hello World"u8.ToArray();
+    var filename = "example.txt";
+    var contentType = "text/plain";
+
+    var request = new FileRequest(content, filename, contentType);
+
+    request.Content.Should().BeEquivalentTo(content);
+    request.Filename.Should().Be(filename);
+    request.ContentType.Should().Be(contentType);
+    request.Purpose.Should().Be("user_upload");
+  }
+
+  [Fact]
+  public void Constructor_WhenContentIsNull_ItShouldThrowArgumentNullException()
+  {
+    var act = () => new FileRequest(null!, "example.txt", "text/plain");
+
+    act.Should().Throw<ArgumentNullException>().WithParameterName("content");
+  }
+
+  [Fact]
+  public void Constructor_WhenFilenameIsNull_ItShouldThrowArgumentException()
+  {
+    var content = "Hello World"u8.ToArray();
+
+    var act = () => new FileRequest(content, null!, "text/plain");
+
+    act.Should().Throw<ArgumentException>().WithParameterName("filename");
+  }
+
+  [Fact]
+  public void Constructor_WhenFilenameIsEmpty_ItShouldThrowArgumentException()
+  {
+    var content = "Hello World"u8.ToArray();
+
+    var act = () => new FileRequest(content, "", "text/plain");
+
+    act.Should().Throw<ArgumentException>().WithParameterName("filename");
+  }
+
+  [Fact]
+  public void Constructor_WhenContentTypeIsNull_ItShouldThrowArgumentException()
+  {
+    var content = "Hello World"u8.ToArray();
+
+    var act = () => new FileRequest(content, "example.txt", null!);
+
+    act.Should().Throw<ArgumentException>().WithParameterName("contentType");
+  }
+
+  [Fact]
+  public void Constructor_WhenContentTypeIsEmpty_ItShouldThrowArgumentException()
+  {
+    var content = "Hello World"u8.ToArray();
+
+    var act = () => new FileRequest(content, "example.txt", "");
+
+    act.Should().Throw<ArgumentException>().WithParameterName("contentType");
+  }
+
+  [Fact]
+  public void Constructor_WhenPurposeIsNull_ItShouldThrowArgumentException()
+  {
+    var content = "Hello World"u8.ToArray();
+
+    var act = () => new FileRequest(content, "example.txt", "text/plain", null!);
+
+    act.Should().Throw<ArgumentException>().WithParameterName("purpose");
+  }
+
+  [Fact]
+  public void Constructor_WhenPurposeIsEmpty_ItShouldThrowArgumentException()
+  {
+    var content = "Hello World"u8.ToArray();
+
+    var act = () => new FileRequest(content, "example.txt", "text/plain", "");
+
+    act.Should().Throw<ArgumentException>().WithParameterName("purpose");
+  }
+}