feat(client): additional methods for positional params

stainless-app[bot] · stainless-app[bot] · commit 130c438b3ce0 · 2025-11-20T05:15:04.000Z
diff --git a/src/ArcadeDotnet.Tests/Services/Admin/AuthProviderServiceTest.cs b/src/ArcadeDotnet.Tests/Services/Admin/AuthProviderServiceTest.cs
@@ -23,23 +23,21 @@ public async Task List_Works()
     [Fact]
     public async Task Delete_Works()
     {
-        var authProviderResponse = await this.client.Admin.AuthProviders.Delete(
-            new() { ID = "id" }
-        );
+        var authProviderResponse = await this.client.Admin.AuthProviders.Delete("id");
         authProviderResponse.Validate();
     }
 
     [Fact]
     public async Task Get_Works()
     {
-        var authProviderResponse = await this.client.Admin.AuthProviders.Get(new() { ID = "id" });
+        var authProviderResponse = await this.client.Admin.AuthProviders.Get("id");
         authProviderResponse.Validate();
     }
 
     [Fact]
     public async Task Patch_Works()
     {
-        var authProviderResponse = await this.client.Admin.AuthProviders.Patch(new() { ID = "id" });
+        var authProviderResponse = await this.client.Admin.AuthProviders.Patch("id");
         authProviderResponse.Validate();
     }
 }
diff --git a/src/ArcadeDotnet.Tests/Services/Admin/SecretServiceTest.cs b/src/ArcadeDotnet.Tests/Services/Admin/SecretServiceTest.cs
@@ -14,6 +14,6 @@ public async Task List_Works()
     [Fact]
     public async Task Delete_Works()
     {
-        await this.client.Admin.Secrets.Delete(new() { SecretID = "secret_id" });
+        await this.client.Admin.Secrets.Delete("secret_id");
     }
 }
diff --git a/src/ArcadeDotnet.Tests/Services/Admin/UserConnectionServiceTest.cs b/src/ArcadeDotnet.Tests/Services/Admin/UserConnectionServiceTest.cs
@@ -14,6 +14,6 @@ public async Task List_Works()
     [Fact]
     public async Task Delete_Works()
     {
-        await this.client.Admin.UserConnections.Delete(new() { ID = "id" });
+        await this.client.Admin.UserConnections.Delete("id");
     }
 }
diff --git a/src/ArcadeDotnet.Tests/Services/ToolServiceTest.cs b/src/ArcadeDotnet.Tests/Services/ToolServiceTest.cs
@@ -30,7 +30,7 @@ public async Task Execute_Works()
     [Fact]
     public async Task Get_Works()
     {
-        var toolDefinition = await this.client.Tools.Get(new() { Name = "name" });
+        var toolDefinition = await this.client.Tools.Get("name");
         toolDefinition.Validate();
     }
 }
diff --git a/src/ArcadeDotnet.Tests/Services/Tools/FormattedServiceTest.cs b/src/ArcadeDotnet.Tests/Services/Tools/FormattedServiceTest.cs
@@ -14,6 +14,6 @@ public async Task List_Works()
     [Fact]
     public async Task Get_Works()
     {
-        await this.client.Tools.Formatted.Get(new() { Name = "name" });
+        await this.client.Tools.Formatted.Get("name");
     }
 }
diff --git a/src/ArcadeDotnet.Tests/Services/Tools/ScheduledServiceTest.cs b/src/ArcadeDotnet.Tests/Services/Tools/ScheduledServiceTest.cs
@@ -14,7 +14,7 @@ public async Task List_Works()
     [Fact]
     public async Task Get_Works()
     {
-        var scheduled = await this.client.Tools.Scheduled.Get(new() { ID = "id" });
+        var scheduled = await this.client.Tools.Scheduled.Get("id");
         scheduled.Validate();
     }
 }
diff --git a/src/ArcadeDotnet.Tests/Services/WorkerServiceTest.cs b/src/ArcadeDotnet.Tests/Services/WorkerServiceTest.cs
@@ -14,7 +14,7 @@ public async Task Create_Works()
     [Fact]
     public async Task Update_Works()
     {
-        var workerResponse = await this.client.Workers.Update(new() { ID = "id" });
+        var workerResponse = await this.client.Workers.Update("id");
         workerResponse.Validate();
     }
 
@@ -28,27 +28,27 @@ public async Task List_Works()
     [Fact]
     public async Task Delete_Works()
     {
-        await this.client.Workers.Delete(new() { ID = "id" });
+        await this.client.Workers.Delete("id");
     }
 
     [Fact]
     public async Task Get_Works()
     {
-        var workerResponse = await this.client.Workers.Get(new() { ID = "id" });
+        var workerResponse = await this.client.Workers.Get("id");
         workerResponse.Validate();
     }
 
     [Fact]
     public async Task Health_Works()
     {
-        var workerHealthResponse = await this.client.Workers.Health(new() { ID = "id" });
+        var workerHealthResponse = await this.client.Workers.Health("id");
         workerHealthResponse.Validate();
     }
 
     [Fact]
     public async Task Tools_Works()
     {
-        var page = await this.client.Workers.Tools(new() { ID = "id" });
+        var page = await this.client.Workers.Tools("id");
         page.Validate();
     }
 }
diff --git a/src/ArcadeDotnet/Models/Admin/AuthProviders/AuthProviderDeleteParams.cs b/src/ArcadeDotnet/Models/Admin/AuthProviders/AuthProviderDeleteParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Admin.AuthProviders;
 /// </summary>
 public sealed record class AuthProviderDeleteParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public AuthProviderDeleteParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Admin/AuthProviders/AuthProviderGetParams.cs b/src/ArcadeDotnet/Models/Admin/AuthProviders/AuthProviderGetParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Admin.AuthProviders;
 /// </summary>
 public sealed record class AuthProviderGetParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public AuthProviderGetParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Admin/AuthProviders/AuthProviderPatchParams.cs b/src/ArcadeDotnet/Models/Admin/AuthProviders/AuthProviderPatchParams.cs
@@ -22,7 +22,7 @@ public IReadOnlyDictionary<string, JsonElement> BodyProperties
         get { return this._bodyProperties.Freeze(); }
     }
 
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public string? ID1
     {
diff --git a/src/ArcadeDotnet/Models/Admin/Secrets/SecretDeleteParams.cs b/src/ArcadeDotnet/Models/Admin/Secrets/SecretDeleteParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Admin.Secrets;
 /// </summary>
 public sealed record class SecretDeleteParams : ParamsBase
 {
-    public required string SecretID { get; init; }
+    public string? SecretID { get; init; }
 
     public SecretDeleteParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Admin/UserConnections/UserConnectionDeleteParams.cs b/src/ArcadeDotnet/Models/Admin/UserConnections/UserConnectionDeleteParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Admin.UserConnections;
 /// </summary>
 public sealed record class UserConnectionDeleteParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public UserConnectionDeleteParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Tools/Formatted/FormattedGetParams.cs b/src/ArcadeDotnet/Models/Tools/Formatted/FormattedGetParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Tools.Formatted;
 /// </summary>
 public sealed record class FormattedGetParams : ParamsBase
 {
-    public required string Name { get; init; }
+    public string? Name { get; init; }
 
     /// <summary>
     /// Provider format
diff --git a/src/ArcadeDotnet/Models/Tools/Scheduled/ScheduledGetParams.cs b/src/ArcadeDotnet/Models/Tools/Scheduled/ScheduledGetParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Tools.Scheduled;
 /// </summary>
 public sealed record class ScheduledGetParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public ScheduledGetParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Tools/ToolGetParams.cs b/src/ArcadeDotnet/Models/Tools/ToolGetParams.cs
@@ -15,7 +15,7 @@ namespace ArcadeDotnet.Models.Tools;
 /// </summary>
 public sealed record class ToolGetParams : ParamsBase
 {
-    public required string Name { get; init; }
+    public string? Name { get; init; }
 
     /// <summary>
     /// Comma separated tool formats that will be included in the response.
diff --git a/src/ArcadeDotnet/Models/Workers/WorkerDeleteParams.cs b/src/ArcadeDotnet/Models/Workers/WorkerDeleteParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Workers;
 /// </summary>
 public sealed record class WorkerDeleteParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public WorkerDeleteParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Workers/WorkerGetParams.cs b/src/ArcadeDotnet/Models/Workers/WorkerGetParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Workers;
 /// </summary>
 public sealed record class WorkerGetParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public WorkerGetParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Workers/WorkerHealthParams.cs b/src/ArcadeDotnet/Models/Workers/WorkerHealthParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Workers;
 /// </summary>
 public sealed record class WorkerHealthParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public WorkerHealthParams() { }
 
diff --git a/src/ArcadeDotnet/Models/Workers/WorkerToolsParams.cs b/src/ArcadeDotnet/Models/Workers/WorkerToolsParams.cs
@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Workers;
 /// </summary>
 public sealed record class WorkerToolsParams : ParamsBase
 {
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     /// <summary>
     /// Number of items to return (default: 25, max: 100)
diff --git a/src/ArcadeDotnet/Models/Workers/WorkerUpdateParams.cs b/src/ArcadeDotnet/Models/Workers/WorkerUpdateParams.cs
@@ -21,7 +21,7 @@ public IReadOnlyDictionary<string, JsonElement> BodyProperties
         get { return this._bodyProperties.Freeze(); }
     }
 
-    public required string ID { get; init; }
+    public string? ID { get; init; }
 
     public bool? Enabled
     {
diff --git a/src/ArcadeDotnet/Services/Admin/AuthProviderService.cs b/src/ArcadeDotnet/Services/Admin/AuthProviderService.cs
@@ -3,6 +3,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using ArcadeDotnet.Core;
+using ArcadeDotnet.Exceptions;
 using ArcadeDotnet.Models.Admin.AuthProviders;
 
 namespace ArcadeDotnet.Services.Admin;
@@ -74,6 +75,11 @@ public async Task<AuthProviderResponse> Delete(
         CancellationToken cancellationToken = default
     )
     {
+        if (parameters.ID == null)
+        {
+            throw new ArcadeInvalidDataException("'parameters.ID' cannot be null");
+        }
+
         HttpRequest<AuthProviderDeleteParams> request = new()
         {
             Method = HttpMethod.Delete,
@@ -92,11 +98,27 @@ public async Task<AuthProviderResponse> Delete(
         return authProviderResponse;
     }
 
+    public async Task<AuthProviderResponse> Delete(
+        string id,
+        AuthProviderDeleteParams? parameters = null,
+        CancellationToken cancellationToken = default
+    )
+    {
+        parameters ??= new();
+
+        return await this.Delete(parameters with { ID = id }, cancellationToken);
+    }
+
     public async Task<AuthProviderResponse> Get(
         AuthProviderGetParams parameters,
         CancellationToken cancellationToken = default
     )
     {
+        if (parameters.ID == null)
+        {
+            throw new ArcadeInvalidDataException("'parameters.ID' cannot be null");
+        }
+
         HttpRequest<AuthProviderGetParams> request = new()
         {
             Method = HttpMethod.Get,
@@ -115,11 +137,27 @@ public async Task<AuthProviderResponse> Get(
         return authProviderResponse;
     }
 
+    public async Task<AuthProviderResponse> Get(
+        string id,
+        AuthProviderGetParams? parameters = null,
+        CancellationToken cancellationToken = default
+    )
+    {
+        parameters ??= new();
+
+        return await this.Get(parameters with { ID = id }, cancellationToken);
+    }
+
     public async Task<AuthProviderResponse> Patch(
         AuthProviderPatchParams parameters,
         CancellationToken cancellationToken = default
     )
     {
+        if (parameters.ID == null)
+        {
+            throw new ArcadeInvalidDataException("'parameters.ID' cannot be null");
+        }
+
         HttpRequest<AuthProviderPatchParams> request = new()
         {
             Method = HttpMethod.Patch,
@@ -137,4 +175,15 @@ public async Task<AuthProviderResponse> Patch(
         }
         return authProviderResponse;
     }
+
+    public async Task<AuthProviderResponse> Patch(
+        string id,
+        AuthProviderPatchParams? parameters = null,
+        CancellationToken cancellationToken = default
+    )
+    {
+        parameters ??= new();
+
+        return await this.Patch(parameters with { ID = id }, cancellationToken);
+    }
 }
diff --git a/src/ArcadeDotnet/Services/Admin/IAuthProviderService.cs b/src/ArcadeDotnet/Services/Admin/IAuthProviderService.cs
@@ -39,6 +39,15 @@ Task<AuthProviderResponse> Delete(
         CancellationToken cancellationToken = default
     );
 
+    /// <summary>
+    /// Delete a specific auth provider
+    /// </summary>
+    Task<AuthProviderResponse> Delete(
+        string id,
+        AuthProviderDeleteParams? parameters = null,
+        CancellationToken cancellationToken = default
+    );
+
     /// <summary>
     /// Get the details of a specific auth provider
     /// </summary>
@@ -47,11 +56,29 @@ Task<AuthProviderResponse> Get(
         CancellationToken cancellationToken = default
     );
 
+    /// <summary>
+    /// Get the details of a specific auth provider
+    /// </summary>
+    Task<AuthProviderResponse> Get(
+        string id,
+        AuthProviderGetParams? parameters = null,
+        CancellationToken cancellationToken = default
+    );
+
     /// <summary>
     /// Patch an existing auth provider
     /// </summary>
     Task<AuthProviderResponse> Patch(
         AuthProviderPatchParams parameters,
         CancellationToken cancellationToken = default
     );
+
+    /// <summary>
+    /// Patch an existing auth provider
+    /// </summary>
+    Task<AuthProviderResponse> Patch(
+        string id,
+        AuthProviderPatchParams? parameters = null,
+        CancellationToken cancellationToken = default
+    );
 }
diff --git a/src/ArcadeDotnet/Services/Admin/ISecretService.cs b/src/ArcadeDotnet/Services/Admin/ISecretService.cs
@@ -27,4 +27,13 @@ Task<SecretListResponse> List(
     /// Delete a secret by its ID
     /// </summary>
     Task Delete(SecretDeleteParams parameters, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Delete a secret by its ID
+    /// </summary>
+    Task Delete(
+        string secretID,
+        SecretDeleteParams? parameters = null,
+        CancellationToken cancellationToken = default
+    );
 }
diff --git a/src/ArcadeDotnet/Services/Admin/IUserConnectionService.cs b/src/ArcadeDotnet/Services/Admin/IUserConnectionService.cs
@@ -30,4 +30,13 @@ Task Delete(
         UserConnectionDeleteParams parameters,
         CancellationToken cancellationToken = default
     );
+
+    /// <summary>
+    /// Delete a user/auth provider connection
+    /// </summary>
+    Task Delete(
+        string id,
+        UserConnectionDeleteParams? parameters = null,
+        CancellationToken cancellationToken = default
+    );
 }
diff --git a/src/ArcadeDotnet/Services/Admin/SecretService.cs b/src/ArcadeDotnet/Services/Admin/SecretService.cs
diff --git a/src/ArcadeDotnet/Services/Admin/UserConnectionService.cs b/src/ArcadeDotnet/Services/Admin/UserConnectionService.cs
diff --git a/src/ArcadeDotnet/Services/IToolService.cs b/src/ArcadeDotnet/Services/IToolService.cs
diff --git a/src/ArcadeDotnet/Services/IWorkerService.cs b/src/ArcadeDotnet/Services/IWorkerService.cs
diff --git a/src/ArcadeDotnet/Services/ToolService.cs b/src/ArcadeDotnet/Services/ToolService.cs
diff --git a/src/ArcadeDotnet/Services/Tools/FormattedService.cs b/src/ArcadeDotnet/Services/Tools/FormattedService.cs
diff --git a/src/ArcadeDotnet/Services/Tools/IFormattedService.cs b/src/ArcadeDotnet/Services/Tools/IFormattedService.cs
diff --git a/src/ArcadeDotnet/Services/Tools/IScheduledService.cs b/src/ArcadeDotnet/Services/Tools/IScheduledService.cs
diff --git a/src/ArcadeDotnet/Services/Tools/ScheduledService.cs b/src/ArcadeDotnet/Services/Tools/ScheduledService.cs
diff --git a/src/ArcadeDotnet/Services/WorkerService.cs b/src/ArcadeDotnet/Services/WorkerService.cs

Original file line number	Diff line number	Diff line change
`@@ -23,23 +23,21 @@ public async Task List_Works()`
`23`	`23`	`[Fact]`
`24`	`24`	`public async Task Delete_Works()`
`25`	`25`	`{`
`26`		`- var authProviderResponse = await this.client.Admin.AuthProviders.Delete(`
`27`		`- new() { ID = "id" }`
`28`		`- );`
	`26`	`+ var authProviderResponse = await this.client.Admin.AuthProviders.Delete("id");`
`29`	`27`	`authProviderResponse.Validate();`
`30`	`28`	`}`
`31`	`29`
`32`	`30`	`[Fact]`
`33`	`31`	`public async Task Get_Works()`
`34`	`32`	`{`
`35`		`- var authProviderResponse = await this.client.Admin.AuthProviders.Get(new() { ID = "id" });`
	`33`	`+ var authProviderResponse = await this.client.Admin.AuthProviders.Get("id");`
`36`	`34`	`authProviderResponse.Validate();`
`37`	`35`	`}`
`38`	`36`
`39`	`37`	`[Fact]`
`40`	`38`	`public async Task Patch_Works()`
`41`	`39`	`{`
`42`		`- var authProviderResponse = await this.client.Admin.AuthProviders.Patch(new() { ID = "id" });`
	`40`	`+ var authProviderResponse = await this.client.Admin.AuthProviders.Patch("id");`
`43`	`41`	`authProviderResponse.Validate();`
`44`	`42`	`}`
`45`	`43`	`}`
Original file line number	Diff line number	Diff line change
`@@ -14,6 +14,6 @@ public async Task List_Works()`
`14`	`14`	`[Fact]`
`15`	`15`	`public async Task Delete_Works()`
`16`	`16`	`{`
`17`		`- await this.client.Admin.Secrets.Delete(new() { SecretID = "secret_id" });`
	`17`	`+ await this.client.Admin.Secrets.Delete("secret_id");`
`18`	`18`	`}`
`19`	`19`	`}`
Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@ public async Task Execute_Works()`
`30`	`30`	`[Fact]`
`31`	`31`	`public async Task Get_Works()`
`32`	`32`	`{`
`33`		`- var toolDefinition = await this.client.Tools.Get(new() { Name = "name" });`
	`33`	`+ var toolDefinition = await this.client.Tools.Get("name");`
`34`	`34`	`toolDefinition.Validate();`
`35`	`35`	`}`
`36`	`36`	`}`
Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@ public async Task List_Works()`
`14`	`14`	`[Fact]`
`15`	`15`	`public async Task Get_Works()`
`16`	`16`	`{`
`17`		`- var scheduled = await this.client.Tools.Scheduled.Get(new() { ID = "id" });`
	`17`	`+ var scheduled = await this.client.Tools.Scheduled.Get("id");`
`18`	`18`	`scheduled.Validate();`
`19`	`19`	`}`
`20`	`20`	`}`
Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@ public async Task Create_Works()`
`14`	`14`	`[Fact]`
`15`	`15`	`public async Task Update_Works()`
`16`	`16`	`{`
`17`		`- var workerResponse = await this.client.Workers.Update(new() { ID = "id" });`
	`17`	`+ var workerResponse = await this.client.Workers.Update("id");`
`18`	`18`	`workerResponse.Validate();`
`19`	`19`	`}`
`20`	`20`
`@@ -28,27 +28,27 @@ public async Task List_Works()`
`28`	`28`	`[Fact]`
`29`	`29`	`public async Task Delete_Works()`
`30`	`30`	`{`
`31`		`- await this.client.Workers.Delete(new() { ID = "id" });`
	`31`	`+ await this.client.Workers.Delete("id");`
`32`	`32`	`}`
`33`	`33`
`34`	`34`	`[Fact]`
`35`	`35`	`public async Task Get_Works()`
`36`	`36`	`{`
`37`		`- var workerResponse = await this.client.Workers.Get(new() { ID = "id" });`
	`37`	`+ var workerResponse = await this.client.Workers.Get("id");`
`38`	`38`	`workerResponse.Validate();`
`39`	`39`	`}`
`40`	`40`
`41`	`41`	`[Fact]`
`42`	`42`	`public async Task Health_Works()`
`43`	`43`	`{`
`44`		`- var workerHealthResponse = await this.client.Workers.Health(new() { ID = "id" });`
	`44`	`+ var workerHealthResponse = await this.client.Workers.Health("id");`
`45`	`45`	`workerHealthResponse.Validate();`
`46`	`46`	`}`
`47`	`47`
`48`	`48`	`[Fact]`
`49`	`49`	`public async Task Tools_Works()`
`50`	`50`	`{`
`51`		`- var page = await this.client.Workers.Tools(new() { ID = "id" });`
	`51`	`+ var page = await this.client.Workers.Tools("id");`
`52`	`52`	`page.Validate();`
`53`	`53`	`}`
`54`	`54`	`}`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ namespace ArcadeDotnet.Models.Admin.AuthProviders;`
`13`	`13`	`/// </summary>`
`14`	`14`	`public sealed record class AuthProviderDeleteParams : ParamsBase`
`15`	`15`	`{`
`16`		`- public required string ID { get; init; }`
	`16`	`+ public string? ID { get; init; }`
`17`	`17`
`18`	`18`	`public AuthProviderDeleteParams() { }`
`19`	`19`
Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,7 @@ public IReadOnlyDictionary<string, JsonElement> BodyProperties`
`22`	`22`	`get { return this._bodyProperties.Freeze(); }`
`23`	`23`	`}`
`24`	`24`
`25`		`- public required string ID { get; init; }`
	`25`	`+ public string? ID { get; init; }`
`26`	`26`
`27`	`27`	`public string? ID1`
`28`	`28`	`{`