implement addition of captions and some logging

Author: dsding2

ClassTranscribeServer/Controllers/CaptionsController.cs

@@ -24,13 +24,16 @@ public class CaptionsController : BaseController
         private readonly CaptionQueries _captionQueries;
         private readonly SubParser parser = new SubParser();
 
+        private ILogger<CaptionsController> _logger;
+
         public CaptionsController(WakeDownloader wakeDownloader,
             CTDbContext context,
             CaptionQueries captionQueries,
             ILogger<CaptionsController> logger) : base(context, logger)
         {
             _captionQueries = captionQueries;
             _wakeDownloader = wakeDownloader;
+            _logger = logger;
         }
 
         // GET: api/Captions/ByTranscription/5
@@ -72,6 +75,9 @@ public async Task<ActionResult<string>> GetTranscriptionFile(string Transcriptio
         [HttpGet]
         public async Task<ActionResult<Caption>> GetCaption(string transcriptionId, int index)
         {
+            // Note here that captions are effectively "stacked" on top of all other captions with the
+            // same transcription Id and Index.
+            // Then, getting a caption only returns the top caption of the stack with the newest creation date.
             var captions = await _context.Captions.Where(c => c.TranscriptionId == transcriptionId && c.Index == index)
                 .OrderByDescending(c => c.CreatedAt).ToListAsync();
             if (captions == null || captions.Count == 0)
@@ -88,6 +94,9 @@ public async Task<ActionResult<Caption>> GetCaption(string transcriptionId, int
         [HttpPost]
         public async Task<ActionResult<Caption>> PostCaption(Caption modifiedCaption)
         {
+            // This endpoint should handle deletion as well, which is represented by posting a caption
+            // with the empty string as text.
+            _logger.LogInformation("DEBUG Id: {Id}, Text: {Text}, Begin: {Begin}, End: {End}", modifiedCaption.Id, modifiedCaption.Text, modifiedCaption.Begin, modifiedCaption.End);
             if (modifiedCaption == null || modifiedCaption.Id == null)
             {
                 return BadRequest("modifiedCaption.Id not present");
@@ -108,7 +117,31 @@ public async Task<ActionResult<Caption>> PostCaption(Caption modifiedCaption)
             };
             _context.Captions.Add(newCaption);
             await _context.SaveChangesAsync();
-            // nope _wakeDownloader.UpdateVTTFile(oldCaption.TranscriptionId);
+            return newCaption;
+        }
+
+        // POST: api/Captions/Add
+        [HttpPost("Add")]
+        public async Task<ActionResult<Caption>> AddCaption(Caption newCaption)
+        {
+            if (newCaption == null) {
+                return BadRequest("newCaption not present");
+            }
+            var allCaptions = await _context.Captions.Where(c => c.TranscriptionId == newCaption.TranscriptionId).ToListAsync();
+            // Every new caption must have a unique index to avoid conflicts with existing indices.
+            var newIndex = allCaptions.Max(c => c.Index) + 1;
+
+            Caption addedCaption = new Caption
+            {
+                Begin = newCaption.Begin,
+                End = newCaption.End,
+                Index = newIndex,
+                CaptionType = newCaption.CaptionType,
+                Text = newCaption.Text,
+                TranscriptionId = newCaption.TranscriptionId
+            };
+            _context.Captions.Add(addedCaption);
+            await _context.SaveChangesAsync();
             return newCaption;
         }