SF-3567 Add new books to a project from a draft

Author: pmachapman

src/SIL.XForge.Scripture/Controllers/SFProjectsRpcController.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Globalization;
 using System.Threading;
 using System.Threading.Tasks;
 using EdjCase.JsonRpc.Router.Abstractions;
@@ -34,6 +35,44 @@ IUserAccessor userAccessor
     // Keep a reference in this class to prevent duplicate allocation (Warning CS9107)
     private readonly IExceptionHandler _exceptionHandler = exceptionHandler;
 
+    public IRpcMethodResult ApplyPreTranslationToProject(
+        string projectId,
+        string scriptureRange,
+        string targetProjectId,
+        DateTime timestamp
+    )
+    {
+        try
+        {
+            // Run the background job
+            backgroundJobClient.Enqueue<IMachineApiService>(r =>
+                r.ApplyPreTranslationToProjectAsync(
+                    UserId,
+                    projectId,
+                    scriptureRange,
+                    targetProjectId,
+                    timestamp,
+                    CancellationToken.None
+                )
+            );
+            return Ok();
+        }
+        catch (Exception)
+        {
+            _exceptionHandler.RecordEndpointInfoForException(
+                new Dictionary<string, string>
+                {
+                    { "method", "ApplyPreTranslationToProject" },
+                    { "projectId", projectId },
+                    { "scriptureRange", scriptureRange },
+                    { "targetProjectId", targetProjectId },
+                    { "timestamp", timestamp.ToString(CultureInfo.InvariantCulture) },
+                }
+            );
+            throw;
+        }
+    }
+
     public async Task<IRpcMethodResult> Create(SFProjectCreateSettings settings)
     {
         try

src/SIL.XForge.Scripture/Models/DraftApplyResult.cs

@@ -0,0 +1,24 @@
+using System.Collections.Generic;
+
+namespace SIL.XForge.Scripture.Models;
+
+/// <summary>
+/// The result of applying a draft.
+/// </summary>
+public class DraftApplyResult
+{
+    /// <summary>
+    /// Whether changes were saved to the database.
+    /// </summary>
+    public bool ChangesSaved { get; set; }
+
+    /// <summary>
+    /// A list of any chapters that failed to apply in the format "GEN 1".
+    /// </summary>
+    public List<string> Failures = [];
+
+    /// <summary>
+    /// A log containing any warnings or errors that occurred while applying the draft.
+    /// </summary>
+    public string Log { get; set; } = string.Empty;
+}

src/SIL.XForge.Scripture/Models/DraftApplyState.cs

@@ -0,0 +1,8 @@
+namespace SIL.XForge.Scripture.Models;
+
+public class DraftApplyState
+{
+    public bool Failed { get; set; }
+    public string? State { get; set; }
+    public bool Success { get; set; }
+}

src/SIL.XForge.Scripture/Services/DeltaUsxMapper.cs

@@ -3,6 +3,7 @@
 using System.Globalization;
 using System.IO;
 using System.Linq;
+using System.Text.RegularExpressions;
 using System.Xml.Linq;
 using System.Xml.Schema;
 using Microsoft.Extensions.Logging;
@@ -11,7 +12,7 @@
 
 namespace SIL.XForge.Scripture.Services;
 
-public class DeltaUsxMapper(
+public partial class DeltaUsxMapper(
     IGuidService guidService,
     ILogger<DeltaUsxMapper> logger,
     IExceptionHandler exceptionHandler
@@ -171,6 +172,15 @@ private static bool CanParaContainVerseText(string? style)
         return ParagraphPoetryListStyles.Contains(style);
     }
 
+    [GeneratedRegex(@"\\id\s+(\w+)", RegexOptions.Compiled)]
+    private static partial Regex BookIdRegex();
+
+    public static string ExtractBookId(string usfm)
+    {
+        string firstLine = usfm.Split('\n').FirstOrDefault()?.Trim() ?? string.Empty;
+        return BookIdRegex().Match(firstLine).Groups[1].Value;
+    }
+
     /// <summary>
     /// Create list of ChapterDelta objects from USX.
     ///

src/SIL.XForge.Scripture/Services/IMachineApiService.cs

@@ -14,6 +14,17 @@ namespace SIL.XForge.Scripture.Services;
 [Intercept(typeof(EventMetricLogger))]
 public interface IMachineApiService
 {
+    [Mutex]
+    [LogEventMetric(EventScope.Drafting, nameof(curUserId), nameof(sfProjectId), captureReturnValue: true)]
+    Task<DraftApplyResult> ApplyPreTranslationToProjectAsync(
+        string curUserId,
+        string sfProjectId,
+        string scriptureRange,
+        string targetProjectId,
+        DateTime timestamp,
+        CancellationToken cancellationToken
+    );
+
     [LogEventMetric(EventScope.Drafting, nameof(sfProjectId))]
     Task BuildCompletedAsync(string sfProjectId, string buildId, string buildState, Uri websiteUrl);
 

src/SIL.XForge.Scripture/Services/INotifier.cs

@@ -6,6 +6,7 @@ namespace SIL.XForge.Scripture.Services;
 public interface INotifier
 {
     Task NotifyBuildProgress(string sfProjectId, ServalBuildState buildState);
+    Task NotifyDraftApplyProgress(string sfProjectId, DraftApplyState draftApplyState);
     Task NotifySyncProgress(string sfProjectId, ProgressState progressState);
     Task SubscribeToProject(string projectId);
 }

src/SIL.XForge.Scripture/Services/ISFProjectService.cs

@@ -64,6 +64,7 @@ Task UpdatePermissionsAsync(
         string curUserId,
         IDocument<SFProject> projectDoc,
         IReadOnlyList<ParatextProjectUser>? users = null,
+        IReadOnlyList<int>? books = null,
         CancellationToken token = default
     );
     Task EnsureWritingSystemTagIsSetAsync(string curUserId, string projectId);