An activity interface

src/Yavsc.Api.Client/ActivityApiClient.cs

@@ -0,0 +1,56 @@
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using Yavsc.Abstract.Workflow;
+
+namespace Yavsc.Api.Client;
+
+/// <summary>
+/// HTTP client for browsing business activities and their performers.
+/// Uses absolute URLs so it can coexist with other Yavsc clients that
+/// target a different API host on the same shared transport.
+/// </summary>
+public sealed class ActivityApiClient
+{
+    private const string PathPrefix = "activity";
+
+    private readonly IYavscApiClient _api;
+    private readonly Uri _baseAddress;
+
+    public ActivityApiClient(IYavscApiClient api, string businessBaseAddress)
+    {
+        _api = api ?? throw new ArgumentNullException(nameof(api));
+        if (string.IsNullOrEmpty(businessBaseAddress))
+            throw new ArgumentException("Base address is required.", nameof(businessBaseAddress));
+
+        _baseAddress = new Uri(businessBaseAddress, UriKind.Absolute);
+    }
+
+    public Task<List<ActivityBrowseItemDto>> GetCatalogAsync(
+        string? parentCode = null,
+        CancellationToken ct = default)
+    {
+        var path = string.IsNullOrWhiteSpace(parentCode)
+            ? $"{PathPrefix}/catalog"
+            : $"{PathPrefix}/catalog?parentCode={Uri.EscapeDataString(parentCode)}";
+
+        return _api.CallAsync<List<ActivityBrowseItemDto>>(HttpMethod.Get, Absolute(path), ct: ct);
+    }
+
+    public Task<List<ActivityPerformerDto>> GetPerformersAsync(
+        string activityCode,
+        CancellationToken ct = default)
+    {
+        if (string.IsNullOrWhiteSpace(activityCode))
+            throw new ArgumentException("Activity code is required.", nameof(activityCode));
+
+        return _api.CallAsync<List<ActivityPerformerDto>>(
+            HttpMethod.Get,
+            Absolute($"{PathPrefix}/{Uri.EscapeDataString(activityCode)}/performers"),
+            ct: ct);
+    }
+
+    private string Absolute(string relativePath) => new Uri(_baseAddress, relativePath).ToString();
+}