SDK regeneration

Author: fern-api[bot]

reference.md

@@ -0,0 +1,20 @@
+<!--
+Configure additional MSBuild properties for your project in this file:
+- Step 1: Add this file to your .fernignore file to ensure it is not overwritten.
+- Step 2: Modify this file to your liking.
+-->
+<Project>
+  <!--
+    <PropertyGroup>
+        <Title>Contoso SDK</Title>
+        <Authors>Contoso</Authors>
+        <Company>Contoso</Company>
+        <AssemblyName>Contoso.Sdk</AssemblyName>
+        <AssemblyTitle>Contoso SDK</AssemblyTitle>
+        <PackageIcon>icon.png</PackageIcon>
+    </PropertyGroup>
+    <ItemGroup>
+        <None Include="..\..\icon.png" Pack="true" PackagePath="" />
+    </ItemGroup>
+    -->
+</Project>

src/AssemblyAI/AssemblyAI.Custom.props

@@ -0,0 +1,53 @@
+using System.Runtime.Serialization;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace AssemblyAI.Core;
+
+internal class EnumSerializer<TEnum> : JsonConverter<TEnum>
+    where TEnum : struct, System.Enum
+{
+    private readonly Dictionary<TEnum, string> _enumToString = new();
+    private readonly Dictionary<string, TEnum> _stringToEnum = new();
+
+    public EnumSerializer()
+    {
+        var type = typeof(TEnum);
+        var values = Enum.GetValues(type);
+
+        foreach (var value in values)
+        {
+            var enumValue = (TEnum)value;
+            var enumMember = type.GetMember(enumValue.ToString())[0];
+            var attr = enumMember
+                .GetCustomAttributes(typeof(EnumMemberAttribute), false)
+                .Cast<EnumMemberAttribute>()
+                .FirstOrDefault();
+
+            var stringValue =
+                attr?.Value
+                ?? value.ToString()
+                ?? throw new Exception("Unexpected null enum toString value");
+
+            _enumToString.Add(enumValue, stringValue);
+            _stringToEnum.Add(stringValue, enumValue);
+        }
+    }
+
+    public override TEnum Read(
+        ref Utf8JsonReader reader,
+        System.Type typeToConvert,
+        JsonSerializerOptions options
+    )
+    {
+        var stringValue =
+            reader.GetString()
+            ?? throw new Exception("The JSON value could not be read as a string.");
+        return _stringToEnum.TryGetValue(stringValue, out var enumValue) ? enumValue : default;
+    }
+
+    public override void Write(Utf8JsonWriter writer, TEnum value, JsonSerializerOptions options)
+    {
+        writer.WriteStringValue(_enumToString[value]);
+    }
+}

src/AssemblyAI/Core/EnumSerializer.cs

@@ -4,11 +4,11 @@ namespace AssemblyAI.Core;
 
 internal static class Extensions
 {
-    internal static string Stringify(this Enum value)
+    public static string Stringify(this Enum value)
     {
         var field = value.GetType().GetField(value.ToString());
         var attribute = (EnumMemberAttribute)
-            Attribute.GetCustomAttribute(field!, typeof(EnumMemberAttribute))!;
+            Attribute.GetCustomAttribute(field, typeof(EnumMemberAttribute));
         return attribute?.Value ?? value.ToString();
     }
 }

src/AssemblyAI/Core/Extensions.cs

@@ -0,0 +1,34 @@
+using System;
+using System.Net.Http;
+
+#nullable enable
+
+namespace AssemblyAI.Core;
+
+internal interface IRequestOptions
+{
+    /// <summary>
+    /// The Base URL for the API.
+    /// </summary>
+    public string? BaseUrl { get; init; }
+
+    /// <summary>
+    /// The http client used to make requests.
+    /// </summary>
+    public HttpClient? HttpClient { get; init; }
+
+    /// <summary>
+    /// The http headers sent with the request.
+    /// </summary>
+    internal Headers Headers { get; init; }
+
+    /// <summary>
+    /// The http client used to make requests.
+    /// </summary>
+    public int? MaxRetries { get; init; }
+
+    /// <summary>
+    /// The timeout for the request.
+    /// </summary>
+    public TimeSpan? Timeout { get; init; }
+}

src/AssemblyAI/Core/IRequestOptions.cs

@@ -5,10 +5,9 @@
 
 namespace AssemblyAI.Core;
 
-internal class OneOfSerializer<TOneOf> : JsonConverter<TOneOf>
-    where TOneOf : IOneOf
+internal class OneOfSerializer : JsonConverter<IOneOf>
 {
-    public override TOneOf? Read(
+    public override IOneOf? Read(
         ref Utf8JsonReader reader,
         System.Type typeToConvert,
         JsonSerializerOptions options
@@ -17,14 +16,14 @@ JsonSerializerOptions options
         if (reader.TokenType is JsonTokenType.Null)
             return default;
 
-        foreach (var (type, cast) in s_types)
+        foreach (var (type, cast) in GetOneOfTypes(typeToConvert))
         {
             try
             {
                 var readerCopy = reader;
                 var result = JsonSerializer.Deserialize(ref readerCopy, type, options);
                 reader.Skip();
-                return (TOneOf)cast.Invoke(null, [result])!;
+                return (IOneOf)cast.Invoke(null, [result])!;
             }
             catch (JsonException) { }
         }
@@ -34,20 +33,18 @@ JsonSerializerOptions options
         );
     }
 
-    private static readonly (System.Type type, MethodInfo cast)[] s_types = GetOneOfTypes();
-
-    public override void Write(Utf8JsonWriter writer, TOneOf value, JsonSerializerOptions options)
+    public override void Write(Utf8JsonWriter writer, IOneOf value, JsonSerializerOptions options)
     {
         JsonSerializer.Serialize(writer, value.Value, options);
     }
 
-    private static (System.Type type, MethodInfo cast)[] GetOneOfTypes()
+    private static (System.Type type, MethodInfo cast)[] GetOneOfTypes(System.Type typeToConvert)
     {
-        var casts = typeof(TOneOf)
+        var casts = typeToConvert
             .GetRuntimeMethods()
             .Where(m => m.IsSpecialName && m.Name == "op_Implicit")
             .ToArray();
-        var type = typeof(TOneOf);
+        var type = typeToConvert;
         while (type != null)
         {
             if (
@@ -62,6 +59,11 @@ private static (System.Type type, MethodInfo cast)[] GetOneOfTypes()
 
             type = type.BaseType;
         }
-        throw new InvalidOperationException($"{typeof(TOneOf)} isn't OneOf or OneOfBase");
+        throw new InvalidOperationException($"{type} isn't OneOf or OneOfBase");
+    }
+
+    public override bool CanConvert(System.Type typeToConvert)
+    {
+        return typeof(IOneOf).IsAssignableFrom(typeToConvert);
     }
 }

src/AssemblyAI/Core/OneOfSerializer.cs

@@ -1,13 +1,6 @@
-// ReSharper disable CheckNamespace
 namespace AssemblyAI;
 
-/// <summary>
-/// Available AssemblyAI API environments
-/// </summary>
-public static class AssemblyAIClientEnvironment
+public class AssemblyAIClientEnvironment
 {
-    /// <summary>
-    /// The default base URL for the AssemblyAI API.
-    /// </summary>
-    public const string Default = "https://api.assemblyai.com";
+    public static string Default = "https://api.assemblyai.com";
 }

src/AssemblyAI/Core/Public/AssemblyAIClientEnvironment.cs

@@ -1,6 +1,8 @@
+using System;
 using System.Net.Http;
 using AssemblyAI.Core;
-// ReSharper disable CheckNamespace
+
+#nullable enable
 
 namespace AssemblyAI;
 
@@ -9,25 +11,40 @@ public partial class ClientOptions
     /// <summary>
     /// The Base URL for the API.
     /// </summary>
-    public string BaseUrl { get; set; } = AssemblyAIClientEnvironment.Default;
+    public string BaseUrl { get; init; } = AssemblyAIClientEnvironment.Default;
 
     /// <summary>
     /// The http client used to make requests.
     /// </summary>
-    public HttpClient HttpClient { get; set; } = new();
+    public HttpClient HttpClient { get; init; } = new HttpClient();
 
     /// <summary>
-    /// The amount to retry sending the HTTP request if it fails.
+    /// The http client used to make requests.
     /// </summary>
-    public int MaxRetries { get; set; } = 2;
+    public int MaxRetries { get; init; } = 2;
 
     /// <summary>
     /// The timeout for the request.
     /// </summary>
-    public TimeSpan Timeout { get; set; } = TimeSpan.FromSeconds(30);
+    public TimeSpan Timeout { get; init; } = TimeSpan.FromSeconds(30);
 
     /// <summary>
     /// The http headers sent with the request.
     /// </summary>
     internal Headers Headers { get; init; } = new();
+
+    /// <summary>
+    /// Clones this and returns a new instance
+    /// </summary>
+    internal ClientOptions Clone()
+    {
+        return new ClientOptions
+        {
+            BaseUrl = BaseUrl,
+            HttpClient = HttpClient,
+            MaxRetries = MaxRetries,
+            Timeout = Timeout,
+            Headers = new Headers(new Dictionary<string, HeaderValue>(Headers)),
+        };
+    }
 }