feat: allow calling with arraylike parameters

Author: davhdavh

Catglobe.CgScript.Runtime/ApiClientBase.cs

@@ -11,6 +11,9 @@ internal abstract class ApiClientBase(HttpClient httpClient, ILogger<ICgScriptAp
    public async Task<ScriptResult<TR>> Execute<TP, TR>(string scriptName, TP parameter, JsonTypeInfo<TP> callJsonTypeInfo, JsonTypeInfo<TR> resultJsonTypeInfo, CancellationToken cancellationToken) =>
       await ParseResponse(await httpClient.PostAsync(await GetPath(scriptName), await GetJsonContent(scriptName, parameter, callJsonTypeInfo), cancellationToken).ConfigureAwait(false), resultJsonTypeInfo, cancellationToken);
 
+   public async Task<ScriptResult<TR>> ExecuteArray<TP, TR>(string scriptName, TP parameter, JsonTypeInfo<TP> callJsonTypeInfo, JsonTypeInfo<TR> resultJsonTypeInfo, CancellationToken cancellationToken) =>
+      await ParseResponse(await httpClient.PostAsync(await GetPath(scriptName, "?expandParameters=true"), await GetJsonContent(scriptName, parameter, callJsonTypeInfo), cancellationToken).ConfigureAwait(false), resultJsonTypeInfo, cancellationToken);
+
    public async Task<ScriptResult<TR>> Execute<TR>(string scriptName, JsonTypeInfo<TR> resultJsonTypeInfo, CancellationToken cancellationToken = default) =>
       await ParseResponse(await httpClient.PostAsync(await GetPath(scriptName, "?expandParameters=true"), await GetJsonContent(scriptName, null, (JsonTypeInfo<object>)null!), cancellationToken).ConfigureAwait(false), resultJsonTypeInfo, cancellationToken);
 
@@ -30,6 +33,9 @@ private async Task<ScriptResult<TR>> ParseResponse<TR>(HttpResponseMessage call,
    [RequiresUnreferencedCode("JSON")]
    public async Task<ScriptResult<TR>> Execute<TP, TR>(string scriptName, TP parameter, JsonSerializerOptions? options, CancellationToken cancellationToken = default) =>
       await ParseResponse<TR>(await httpClient.PostAsync(await GetPath(scriptName), await GetJsonContent(scriptName, parameter, options), cancellationToken).ConfigureAwait(false), options, cancellationToken);
+   [RequiresUnreferencedCode("JSON")]
+   public async Task<ScriptResult<TR>> ExecuteArray<TP, TR>(string scriptName, TP parameter, JsonSerializerOptions? options, CancellationToken cancellationToken = default) =>
+      await ParseResponse<TR>(await httpClient.PostAsync(await GetPath(scriptName, "?expandParameters=true"), await GetJsonContent(scriptName, parameter, options), cancellationToken).ConfigureAwait(false), options, cancellationToken);
 
    [RequiresUnreferencedCode("JSON")]
    public async Task<ScriptResult<TR>> Execute<TR>(string scriptName, IReadOnlyCollection<object> parameters, JsonSerializerOptions? options = null, CancellationToken cancellationToken = default) =>

Catglobe.CgScript.Runtime/ICgScriptApiClient.cs

@@ -20,6 +20,17 @@ public interface ICgScriptApiClient
    /// <returns>A results object that contains the message from the server</returns>
    public Task<ScriptResult<TR>> Execute<TP, TR>(string scriptName, TP parameter, JsonTypeInfo<TP> callJsonTypeInfo, JsonTypeInfo<TR> resultJsonTypeInfo, CancellationToken cancellationToken = default);
 
+   /// <summary>
+   /// Execute a script on the server with the parameters expanded, i.e. parameter must serialize to an array.
+   /// </summary>
+   /// <param name="scriptName">Name of script to run</param>
+   /// <param name="parameter">The parameter for the script</param>
+   /// <param name="callJsonTypeInfo">Source generator parser for the parameter</param>
+   /// <param name="resultJsonTypeInfo">Source generator parser for the result</param>
+   /// <param name="cancellationToken">Token to monitor for cancellation requests</param>
+   /// <returns>A results object that contains the message from the server</returns>
+   public Task<ScriptResult<TR>> ExecuteArray<TP, TR>(string scriptName, TP parameter, JsonTypeInfo<TP> callJsonTypeInfo, JsonTypeInfo<TR> resultJsonTypeInfo, CancellationToken cancellationToken = default);
+
    /// <summary>
    /// Execute a script on the server.
    /// </summary>
@@ -43,6 +54,20 @@ public interface ICgScriptApiClient
    [RequiresUnreferencedCode("JSON")]
    public Task<ScriptResult<TR>> Execute<TP, TR>(string scriptName, TP parameter, JsonSerializerOptions? options = null, CancellationToken cancellationToken = default);
 
+   /// <summary>
+   /// Execute a script on the server with the parameters expanded, i.e. parameter must serialize to an array.
+   /// </summary>
+   /// <remarks>
+   /// Not recommended to use. Prefer a model that uses <see cref="ExecuteArray{TP,TR}(string,TP,JsonTypeInfo{TP},JsonTypeInfo{TR},CancellationToken)"/>.
+   /// </remarks>
+   /// <param name="scriptName">Name of script to run</param>
+   /// <param name="parameter">The parameter for the script</param>
+   /// <param name="options">Options that will tell us how to serialize parameters and deserialize result. Can be null</param>
+   /// <param name="cancellationToken">Token to monitor for cancellation requests</param>
+   /// <returns>A results object that contains the message from the server</returns>
+   [RequiresUnreferencedCode("JSON")]
+   public Task<ScriptResult<TR>> ExecuteArray<TP, TR>(string scriptName, TP parameter, JsonSerializerOptions? options = null, CancellationToken cancellationToken = default);
+
    /// <summary>
    /// Execute a script on the server.
    /// </summary>