feat(segments): add SegmentUpdateAsync for PATCH /segments/:id

src/Resend/IResend.cs

@@ -955,6 +955,15 @@ public interface IResend
     /// <returns>Segment.</returns>
     Task<ResendResponse<Segment>> SegmentRetrieveAsync( Guid segmentId, CancellationToken cancellationToken = default );
 
+    /// <summary>
+    /// Updates a segment.
+    /// </summary>
+    /// <param name="segmentId">Segment identifier.</param>
+    /// <param name="segment">Segment data.</param>
+    /// <param name="cancellationToken">Cancelation token.</param>
+    /// <returns>Updated segment.</returns>
+    Task<ResendResponse<SegmentUpdateResult>> SegmentUpdateAsync( Guid segmentId, SegmentData segment, CancellationToken cancellationToken = default );
+
     /// <summary>
     /// Deletes a segment.
     /// </summary>

src/Resend/README.md

@@ -20,7 +20,7 @@ The `ResendClient` supports the following objects (and methods):
 * Broadcast (List, Add, Retrieve, Update, Send, Schedule, Delete)
 * Audience (List, Add, Retrieve, Delete)
 * Contact (List, Add, Retrieve, Update, Delete)
-* Segment (List, Create, Retrieve, Delete)
+* Segment (List, Create, Retrieve, Update, Delete)
 * Topics (List, Create, Retrieve, Update, Delete)
 * Templates (List, Create, Retrieve, Update, Delete, Publish, Duplicate)
 * Webhooks (List, Create, Retrieve, Update, Delete)

src/Resend/ResendClient.Segments.cs

@@ -54,6 +54,17 @@ public partial class ResendClient
     }
 
 
+    /// <inheritdoc />
+    public Task<ResendResponse<SegmentUpdateResult>> SegmentUpdateAsync( Guid segmentId, SegmentData segment, CancellationToken cancellationToken = default )
+    {
+        var path = $"/segments/{segmentId}";
+        var req = new HttpRequestMessage( HttpMethod.Patch, path );
+        req.Content = JsonContent.Create( segment );
+
+        return Execute<SegmentUpdateResult, SegmentUpdateResult>( req, ( x ) => x, cancellationToken );
+    }
+
+
     /// <inheritdoc />
     public Task<ResendResponse> SegmentDeleteAsync( Guid segmentId, CancellationToken cancellationToken = default )
     {

src/Resend/SegmentUpdateResult.cs

@@ -0,0 +1,21 @@
+using System.Text.Json.Serialization;
+
+namespace Resend;
+
+/// <summary>
+/// Result of updating a segment.
+/// </summary>
+public class SegmentUpdateResult
+{
+    /// <summary>
+    /// Object type discriminator.
+    /// </summary>
+    [JsonPropertyName( "object" )]
+    public string Object { get; set; } = default!;
+
+    /// <summary>
+    /// Segment identifier.
+    /// </summary>
+    [JsonPropertyName( "id" )]
+    public Guid Id { get; set; }
+}

tests/Resend.Tests/ResendClientTests.Segment.cs

@@ -0,0 +1,21 @@
+namespace Resend.Tests;
+
+/// <summary />
+public partial class ResendClientTests
+{
+    /// <summary/>
+    [Fact]
+    public async Task SegmentUpdate()
+    {
+        var segmentId = Guid.NewGuid();
+
+        var resp = await _resend.SegmentUpdateAsync( segmentId, new SegmentData()
+        {
+            Name = "Renamed segment",
+        } );
+
+        Assert.NotNull( resp );
+        Assert.NotNull( resp.Content );
+        Assert.Equal( segmentId, resp.Content.Id );
+    }
+}

tools/Resend.ApiServer/Controllers/SegmentController.cs

@@ -0,0 +1,32 @@
+using Microsoft.AspNetCore.Mvc;
+
+namespace Resend.ApiServer.Controllers;
+
+/// <summary />
+[ApiController]
+public class SegmentController : ControllerBase
+{
+    private readonly ILogger<SegmentController> _logger;
+
+
+    /// <summary />
+    public SegmentController( ILogger<SegmentController> logger )
+    {
+        _logger = logger;
+    }
+
+
+    /// <summary />
+    [HttpPatch]
+    [Route( "segments/{id}" )]
+    public SegmentUpdateResult SegmentUpdate( [FromRoute] Guid id, [FromBody] SegmentData data )
+    {
+        _logger.LogDebug( "SegmentUpdate" );
+
+        return new SegmentUpdateResult()
+        {
+            Object = "segment",
+            Id = id,
+        };
+    }
+}

tools/Resend.Cli/Segment/SegmentUpdateCommand.cs

@@ -0,0 +1,42 @@
+using McMaster.Extensions.CommandLineUtils;
+using System.ComponentModel.DataAnnotations;
+
+namespace Resend.Cli.Segment;
+
+/// <summary />
+[Command( "update", Description = "Update a segment" )]
+public class SegmentUpdateCommand
+{
+    private readonly IResend _resend;
+
+    /// <summary />
+    [Argument( 0, Description = "Segment identifier" )]
+    [Required]
+    public Guid? SegmentId { get; set; }
+
+    /// <summary />
+    [Argument( 1, Description = "Segment name" )]
+    [Required]
+    public string? Name { get; set; }
+
+
+    /// <summary />
+    public SegmentUpdateCommand( IResend resend )
+    {
+        _resend = resend;
+    }
+
+
+    /// <summary />
+    public async Task<int> OnExecuteAsync()
+    {
+        var data = new SegmentData()
+        {
+            Name = this.Name!,
+        };
+
+        await _resend.SegmentUpdateAsync( this.SegmentId!.Value, data );
+
+        return 0;
+    }
+}

tools/Resend.Cli/SegmentCommand.cs

@@ -8,6 +8,7 @@ namespace Resend.Cli;
 [Subcommand( typeof( Segment.SegmentDeleteCommand ) )]
 [Subcommand( typeof( Segment.SegmentListCommand ) )]
 [Subcommand( typeof( Segment.SegmentRetrieveCommand ) )]
+[Subcommand( typeof( Segment.SegmentUpdateCommand ) )]
 public class SegmentCommand
 {
     /// <summary />