feat: trying to create clips...probs a waste of time grrrrrrr

src/StreamShorts.Library/Media/Video/IShortsCreator.cs

@@ -1,5 +1,20 @@
+using StreamShorts.Library.Analysis;
+
 namespace StreamShorts.Library.Media.Video;
 
+/// <summary>
+/// Represents a service that creates video shorts.
+/// </summary>
 public interface IShortsCreator
 {
+  /// <summary>
+  /// Creates video shorts from the provided transcript analysis and video stream.
+  /// </summary>
+  /// <param name="analysis">The transcript analysis.</param>
+  /// <param name="video">The video stream.</param>
+  /// <param name="buffer">An optional buffer duration to include before the start time and after the end time of each short.</param>
+  /// <returns>An asynchronous enumerable of <see cref="ShortClip"/>.</returns>
+  /// <exception cref="ArgumentNullException">Thrown when <paramref name="analysis"/> is null.</exception>
+  /// <exception cref="ArgumentNullException">Thrown when <paramref name="video"/> is null.</exception>
+  public IAsyncEnumerable<ShortClip> CreateShortsAsync(TranscriptAnalysis analysis, Stream video, TimeSpan? buffer = null);
 }

src/StreamShorts.Library/Media/Video/ShortClip.cs

@@ -0,0 +1,11 @@
+using StreamShorts.Library.Analysis;
+
+namespace StreamShorts.Library.Media.Video;
+
+/// <summary>
+/// Represents a short video clip.
+/// </summary>
+public record ShortClip(
+  ShortCandidate Candidate,
+  Stream Segment
+);

src/StreamShorts.Library/Media/Video/ShortsCreator.cs

@@ -1,5 +1,45 @@
+using StreamShorts.Library.Analysis;
+
 namespace StreamShorts.Library.Media.Video;
 
+/// <summary>
+/// Represents a service that creates video shorts.
+/// </summary>
+/// <inheritdoc/>
 public class ShortsCreator : IShortsCreator
 {
-}
+  private readonly IVideoService _videoService = new FFMpegService();
+
+  public ShortsCreator()
+  {
+  }
+
+  internal ShortsCreator(IVideoService videoService)
+  {
+    _videoService = videoService ?? throw new ArgumentNullException(nameof(videoService), $"{nameof(videoService)} cannot be null");
+  }
+
+  public async IAsyncEnumerable<ShortClip> CreateShortsAsync(TranscriptAnalysis analysis, Stream video, TimeSpan? buffer = null)
+  {
+    if (analysis is null)
+    {
+      throw new ArgumentNullException(nameof(analysis), $"{nameof(analysis)} cannot be null");
+    }
+
+    if (video is null)
+    {
+      throw new ArgumentNullException(nameof(video), $"{nameof(video)} cannot be null");
+    }
+
+    foreach (var candidate in analysis.Candidates)
+    {
+      var clip = await _videoService.ExtractClipFromVideoAsync(video, candidate.StartTime, candidate.EndTime, buffer)
+        .ConfigureAwait(false);
+
+      yield return new ShortClip(
+        candidate,
+        clip
+      );
+    }
+  }
+}