feat(api): composite create-channel endpoint (#63)

2026-07-06 20:27:02 +02:00
parent 16674ba80e
commit 6857a0d191
11 changed files with 1594 additions and 0 deletions
@@ -79,6 +79,25 @@ public class ChannelController(ChannelWriter<IBackgroundServiceRequest> workerCh
            });
    }

+    [HttpPost("/api/channels/from-lineup", Name = "CreateChannelFromLineup")]
+    [Tags("Channels")]
+    [EndpointSummary("Create a channel from a library lineup")]
+    [EndpointDescription(
+        "Atomically creates the channel, generated lineup collection, program schedule, schedule items, " +
+        "and classic playout. Template defaults are stamped at create time; advanced overrides win.")]
+    [EndpointGroupName("general")]
+    [ProducesResponseType(typeof(CreateChannelFromLineupResponseModel), StatusCodes.Status201Created)]
+    [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
+    [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)]
+    public async Task<IActionResult> CreateFromLineup(
+        [Required] [FromBody] CreateChannelFromLineupRequest request,
+        CancellationToken cancellationToken)
+    {
+        Either<BaseError, CreateChannelFromLineupResponseModel> result =
+            await mediator.Send(request.ToCommand(), cancellationToken);
+        return result.ToCreatedResult(response => $"/api/channels/{response.ChannelId}", response => response);
+    }
+
    [HttpPut("/api/channels/{id:int}")]
    [Tags("Channels")]
    [EndpointSummary("Update a channel")]
@@ -0,0 +1,111 @@
+#nullable enable
+
+using ErsatzTV.Application.Artworks;
+using ErsatzTV.Application.Channels;
+using ErsatzTV.Core.Api.LibraryBrowse;
+using ErsatzTV.Core.Domain;
+using ErsatzTV.Core.Scheduling;
+
+namespace ErsatzTV.Controllers.Api.Requests;
+
+public record CreateChannelFromLineupRequest(
+    string Name,
+    string Number,
+    string Group,
+    string Categories,
+    ArtworkContentTypeModel Logo,
+    bool IsEnabled,
+    bool ShowInEpg,
+    int TemplateId,
+    CreateChannelFromLineupAdvancedOptionsRequest? Advanced,
+    List<CreateChannelFromLineupItemRequest> Lineup)
+{
+    public CreateChannelFromLineup ToCommand() =>
+        new(
+            Name,
+            Number,
+            Group,
+            Categories,
+            Logo,
+            IsEnabled,
+            ShowInEpg,
+            TemplateId,
+            Advanced?.ToCommand() ?? new CreateChannelFromLineupAdvancedOptions(),
+            Lineup.Map(i => i.ToCommand()).ToList());
+}
+
+public record CreateChannelFromLineupAdvancedOptionsRequest(
+    PlaybackOrder? PlaybackOrder = null,
+    int? FFmpegProfileId = null,
+    int? WatermarkId = null,
+    int? FallbackFillerId = null,
+    int? PreRollFillerId = null,
+    int? MidRollFillerId = null,
+    int? PostRollFillerId = null,
+    ChannelStreamSelectorMode? StreamSelectorMode = null,
+    string? StreamSelector = null,
+    string? PreferredAudioLanguageCode = null,
+    string? PreferredAudioTitle = null,
+    ChannelPlayoutSource? PlayoutSource = null,
+    ChannelPlayoutMode? PlayoutMode = null,
+    StreamingMode? StreamingMode = null,
+    string? PreferredSubtitleLanguageCode = null,
+    ChannelSubtitleMode? SubtitleMode = null,
+    ChannelMusicVideoCreditsMode? MusicVideoCreditsMode = null,
+    string? MusicVideoCreditsTemplate = null,
+    ChannelSongVideoMode? SongVideoMode = null,
+    ChannelTranscodeMode? TranscodeMode = null,
+    ChannelIdleBehavior? IdleBehavior = null,
+    bool? ShuffleScheduleItems = null,
+    bool? RandomStartPoint = null,
+    FixedStartTimeBehavior? FixedStartTimeBehavior = null)
+{
+    public CreateChannelFromLineupAdvancedOptions ToCommand() =>
+        new(
+            PlaybackOrder,
+            FFmpegProfileId,
+            WatermarkId,
+            FallbackFillerId,
+            PreRollFillerId,
+            MidRollFillerId,
+            PostRollFillerId,
+            StreamSelectorMode,
+            StreamSelector,
+            PreferredAudioLanguageCode,
+            PreferredAudioTitle,
+            PlayoutSource,
+            PlayoutMode,
+            StreamingMode,
+            PreferredSubtitleLanguageCode,
+            SubtitleMode,
+            MusicVideoCreditsMode,
+            MusicVideoCreditsTemplate,
+            SongVideoMode,
+            TranscodeMode,
+            IdleBehavior,
+            ShuffleScheduleItems,
+            RandomStartPoint,
+            FixedStartTimeBehavior);
+}
+
+public record CreateChannelFromLineupItemRequest(
+    LibraryBrowseMediaType MediaType,
+    CollectionType CollectionType,
+    int? CollectionId,
+    int? MultiCollectionId,
+    int? SmartCollectionId,
+    int? RerunCollectionId,
+    int? MediaItemId,
+    int? PlaylistId)
+{
+    public CreateChannelFromLineupItem ToCommand() =>
+        new(
+            MediaType,
+            CollectionType,
+            CollectionId,
+            MultiCollectionId,
+            SmartCollectionId,
+            RerunCollectionId,
+            MediaItemId,
+            PlaylistId);
+}