feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 118
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-ef726ad139fa29757029206ee08150434fc6c52005fec6d42c7d2bcd3aa7ab47.yml
-openapi_spec_hash: e622beb7c26f9b0dd641bd5c92735a5b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-faf1f7c723d2762f09e9690ef2ceda58cb0a6ddacf1a79c3754871b90e7db0dc.yml
+openapi_spec_hash: 22269f85fae1ec920bdb0b32435a7aa8
 config_hash: dd4343ce95871032ef6e0735a4ca038c

src/Orb/Models/Invoices/InvoiceUpdateParams.cs

@@ -9,12 +9,13 @@
 namespace Orb.Models.Invoices;
 
 /// <summary>
-/// This endpoint allows you to update the `metadata`, `net_terms`, and `due_date`
-/// properties on an invoice. If you pass null for the metadata value, it will clear
-/// any existing metadata for that invoice.
+/// This endpoint allows you to update the `metadata`, `net_terms`, `due_date`, and
+/// `invoice_date` properties on an invoice. If you pass null for the metadata value,
+/// it will clear any existing metadata for that invoice.
 ///
-/// `metadata` can be modified regardless of invoice state. `net_terms` and `due_date`
-/// can only be modified if the invoice is in a `draft` state.
+/// `metadata` can be modified regardless of invoice state. `net_terms`, `due_date`,
+/// and `invoice_date` can only be modified if the invoice is in a `draft` state.
+/// `invoice_date` can only be modified for non-subscription invoices.
 /// </summary>
 public sealed record class InvoiceUpdateParams : ParamsBase
 {
@@ -44,6 +45,27 @@ public DueDate? DueDate
         }
     }
 
+    /// <summary>
+    /// The date of the invoice. Can only be modified for one-off draft invoices.
+    /// </summary>
+    public InvoiceDate? InvoiceDate
+    {
+        get
+        {
+            if (!this.BodyProperties.TryGetValue("invoice_date", out JsonElement element))
+                return null;
+
+            return JsonSerializer.Deserialize<InvoiceDate?>(element, ModelBase.SerializerOptions);
+        }
+        set
+        {
+            this.BodyProperties["invoice_date"] = JsonSerializer.SerializeToElement(
+                value,
+                ModelBase.SerializerOptions
+            );
+        }
+    }
+
     /// <summary>
     /// User-specified key/value pairs for the resource. Individual keys can be removed
     /// by setting the value to `null`, and the entire metadata mapping can be cleared

src/Orb/Models/Invoices/InvoiceUpdateParamsProperties/InvoiceDate.cs

@@ -0,0 +1,130 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using Orb.Exceptions;
+
+namespace Orb.Models.Invoices.InvoiceUpdateParamsProperties;
+
+/// <summary>
+/// The date of the invoice. Can only be modified for one-off draft invoices.
+/// </summary>
+[JsonConverter(typeof(InvoiceDateConverter))]
+public record class InvoiceDate
+{
+    public object Value { get; private init; }
+
+    public InvoiceDate(DateOnly value)
+    {
+        Value = value;
+    }
+
+    public InvoiceDate(DateTime value)
+    {
+        Value = value;
+    }
+
+    InvoiceDate(UnknownVariant value)
+    {
+        Value = value;
+    }
+
+    public static InvoiceDate CreateUnknownVariant(JsonElement value)
+    {
+        return new(new UnknownVariant(value));
+    }
+
+    public bool TryPickDate([NotNullWhen(true)] out DateOnly? value)
+    {
+        value = this.Value as DateOnly?;
+        return value != null;
+    }
+
+    public bool TryPickDateTime([NotNullWhen(true)] out DateTime? value)
+    {
+        value = this.Value as DateTime?;
+        return value != null;
+    }
+
+    public void Switch(Action<DateOnly> @date, Action<DateTime> @dateTime)
+    {
+        switch (this.Value)
+        {
+            case DateOnly value:
+                @date(value);
+                break;
+            case DateTime value:
+                @dateTime(value);
+                break;
+            default:
+                throw new OrbInvalidDataException("Data did not match any variant of InvoiceDate");
+        }
+    }
+
+    public T Match<T>(Func<DateOnly, T> @date, Func<DateTime, T> @dateTime)
+    {
+        return this.Value switch
+        {
+            DateOnly value => @date(value),
+            DateTime value => @dateTime(value),
+            _ => throw new OrbInvalidDataException("Data did not match any variant of InvoiceDate"),
+        };
+    }
+
+    public void Validate()
+    {
+        if (this.Value is UnknownVariant)
+        {
+            throw new OrbInvalidDataException("Data did not match any variant of InvoiceDate");
+        }
+    }
+
+    private record struct UnknownVariant(JsonElement value);
+}
+
+sealed class InvoiceDateConverter : JsonConverter<InvoiceDate?>
+{
+    public override InvoiceDate? Read(
+        ref Utf8JsonReader reader,
+        Type typeToConvert,
+        JsonSerializerOptions options
+    )
+    {
+        List<OrbInvalidDataException> exceptions = [];
+
+        try
+        {
+            return new InvoiceDate(JsonSerializer.Deserialize<DateOnly>(ref reader, options));
+        }
+        catch (Exception e) when (e is JsonException || e is OrbInvalidDataException)
+        {
+            exceptions.Add(
+                new OrbInvalidDataException("Data does not match union variant 'DateOnly'", e)
+            );
+        }
+
+        try
+        {
+            return new InvoiceDate(JsonSerializer.Deserialize<DateTime>(ref reader, options));
+        }
+        catch (Exception e) when (e is JsonException || e is OrbInvalidDataException)
+        {
+            exceptions.Add(
+                new OrbInvalidDataException("Data does not match union variant 'DateTime'", e)
+            );
+        }
+
+        throw new AggregateException(exceptions);
+    }
+
+    public override void Write(
+        Utf8JsonWriter writer,
+        InvoiceDate? value,
+        JsonSerializerOptions options
+    )
+    {
+        object? variant = value?.Value;
+        JsonSerializer.Serialize(writer, variant, options);
+    }
+}

src/Orb/Services/Invoices/IInvoiceService.cs

@@ -12,12 +12,13 @@ public interface IInvoiceService
     Task<Invoice> Create(InvoiceCreateParams parameters);
 
     /// <summary>
-    /// This endpoint allows you to update the `metadata`, `net_terms`, and `due_date`
-    /// properties on an invoice. If you pass null for the metadata value, it will
-    /// clear any existing metadata for that invoice.
+    /// This endpoint allows you to update the `metadata`, `net_terms`, `due_date`,
+    /// and `invoice_date` properties on an invoice. If you pass null for the metadata
+    /// value, it will clear any existing metadata for that invoice.
     ///
-    /// `metadata` can be modified regardless of invoice state. `net_terms` and `due_date`
-    /// can only be modified if the invoice is in a `draft` state.
+    /// `metadata` can be modified regardless of invoice state. `net_terms`, `due_date`,
+    /// and `invoice_date` can only be modified if the invoice is in a `draft` state.
+    /// `invoice_date` can only be modified for non-subscription invoices.
     /// </summary>
     Task<Invoice> Update(InvoiceUpdateParams parameters);