Add Update(before, after) API for example sentences

backend/FwLite/FwDataMiniLcmBridge/Api/FwDataMiniLcmApi.cs

@@ -864,6 +864,12 @@ public Task DeleteSense(Guid entryId, Guid senseId)
         return Task.CompletedTask;
     }
 
+    public Task<ExampleSentence?> GetExampleSentence(Guid entryId, Guid senseId, Guid id)
+    {
+        var lcmExampleSentence = ExampleSentenceRepository.GetObject(id);
+        return Task.FromResult(lcmExampleSentence is null ? null : FromLexExampleSentence(senseId, lcmExampleSentence));
+    }
+
     internal void CreateExampleSentence(ILexSense lexSense, ExampleSentence exampleSentence)
     {
         var lexExampleSentence = LexExampleSentenceFactory.Create(exampleSentence.Id, lexSense);
@@ -905,6 +911,20 @@ public Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
         return Task.FromResult(FromLexExampleSentence(senseId, lexExampleSentence));
     }
 
+    public async Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
+        Guid senseId,
+        ExampleSentence before,
+        ExampleSentence after)
+    {
+        await Cache.DoUsingNewOrCurrentUOW("Update Example Sentence",
+            "Revert Example Sentence",
+            async () =>
+            {
+                await ExampleSentenceSync.Sync(entryId, senseId, after, before, this);
+            });
+        return await GetExampleSentence(entryId, senseId, after.Id) ?? throw new NullReferenceException("unable to find example sentence with id " + after.Id);
+    }
+
     public Task DeleteExampleSentence(Guid entryId, Guid senseId, Guid exampleSentenceId)
     {
         var lexExampleSentence = ExampleSentenceRepository.GetObject(exampleSentenceId);

backend/FwLite/FwLiteProjectSync/DryRunMiniLcmApi.cs

@@ -27,7 +27,7 @@
         DryRunRecords.Add(new DryRunRecord(nameof(UpdateWritingSystem),
             $"Update writing system {type}, changes: {update.Summarize()}"));
         var ws = await api.GetWritingSystems();
         return (type switch
         {
             WritingSystemType.Vernacular => ws.Vernacular,
             WritingSystemType.Analysis => ws.Analysis
@@ -182,6 +182,11 @@
         return Task.CompletedTask;
     }
 
+    public Task<ExampleSentence?> GetExampleSentence(Guid entryId, Guid senseId, Guid id)
+    {
+        return api.GetExampleSentence(entryId, senseId, id);
+    }
+
     public Task<ExampleSentence> CreateExampleSentence(Guid entryId, Guid senseId, ExampleSentence exampleSentence)
     {
         DryRunRecords.Add(new DryRunRecord(nameof(CreateExampleSentence), $"Create example sentence {exampleSentence.Sentence}"));
@@ -195,11 +200,17 @@
     {
         DryRunRecords.Add(new DryRunRecord(nameof(UpdateExampleSentence),
             $"Update example sentence {exampleSentenceId}, changes: {update.Summarize()}"));
-        var entry = await GetEntry(entryId) ??
-                    throw new NullReferenceException($"unable to find entry with id {entryId}");
-        var sense = entry.Senses.First(s => s.Id == senseId);
-        var exampleSentence = sense.ExampleSentences.First(s => s.Id == exampleSentenceId);
-        return exampleSentence;
+        var exampleSentence = await GetExampleSentence(entryId, senseId, exampleSentenceId);
+        return exampleSentence ?? throw new NullReferenceException($"unable to find example sentence with id {exampleSentenceId}");
+    }
+
+    public Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
+        Guid senseId,
+        ExampleSentence before,
+        ExampleSentence after)
+    {
+        DryRunRecords.Add(new DryRunRecord(nameof(UpdateExampleSentence), $"Update example sentence {after.Id}"));
+        return Task.FromResult(after);
     }
 
     public Task DeleteExampleSentence(Guid entryId, Guid senseId, Guid exampleSentenceId)

backend/FwLite/LcmCrdt/CrdtMiniLcmApi.cs

@@ -13,7 +13,7 @@
 
 namespace LcmCrdt;
 
 public class CrdtMiniLcmApi(DataModel dataModel, CurrentProjectService projectService, LcmCrdtDbContext dbContext) : IMiniLcmApi
 {
     private Guid ClientId { get; } = projectService.ProjectData.ClientId;
     public ProjectData ProjectData => projectService.ProjectData;
@@ -305,7 +305,7 @@
         ]);
         return await GetEntry(entry.Id) ?? throw new NullReferenceException();
 
         async IAsyncEnumerable<AddEntryComponentChange> ToComplexFormComponents(IList<ComplexFormComponent> complexFormComponents)
         {
             foreach (var complexFormComponent in complexFormComponents)
             {
@@ -442,6 +442,14 @@
         return await dataModel.GetLatest<ExampleSentence>(exampleSentence.Id) ?? throw new NullReferenceException();
     }
 
+    public async Task<ExampleSentence?> GetExampleSentence(Guid entryId, Guid senseId, Guid id)
+    {
+        var exampleSentence = await ExampleSentences.AsTracking(false)
+            .AsQueryable()
+            .SingleOrDefaultAsync(e => e.Id == id);
+        return exampleSentence;
+    }
+
     public async Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
         Guid senseId,
         Guid exampleSentenceId,
@@ -453,6 +461,15 @@
         return await dataModel.GetLatest<ExampleSentence>(exampleSentenceId) ?? throw new NullReferenceException();
     }
 
+    public async Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
+        Guid senseId,
+        ExampleSentence before,
+        ExampleSentence after)
+    {
+        await ExampleSentenceSync.Sync(entryId, senseId, after, before, this);
+        return await GetExampleSentence(entryId, senseId, after.Id) ?? throw new NullReferenceException();
+    }
+
     public async Task DeleteExampleSentence(Guid entryId, Guid senseId, Guid exampleSentenceId)
     {
         await dataModel.AddChange(ClientId, new DeleteChange<ExampleSentence>(exampleSentenceId));

backend/FwLite/MiniLcm/IMiniLcmReadApi.cs

@@ -14,6 +14,7 @@ public interface IMiniLcmReadApi
     Task<Entry?> GetEntry(Guid id);
     Task<PartOfSpeech?> GetPartOfSpeech(Guid id);
     Task<SemanticDomain?> GetSemanticDomain(Guid id);
+    Task<ExampleSentence?> GetExampleSentence(Guid entryId, Guid senseId, Guid id);
 }
 
 public record QueryOptions(

backend/FwLite/MiniLcm/IMiniLcmWriteApi.cs

@@ -53,6 +53,10 @@ Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
         Guid senseId,
         Guid exampleSentenceId,
         UpdateObjectInput<ExampleSentence> update);
+    Task<ExampleSentence> UpdateExampleSentence(Guid entryId,
+        Guid senseId,
+        ExampleSentence before,
+        ExampleSentence after);
 
     Task DeleteExampleSentence(Guid entryId, Guid senseId, Guid exampleSentenceId);
     #endregion

backend/FwLite/MiniLcm/SyncHelpers/ExampleSentenceSync.cs

@@ -22,13 +22,8 @@ public static async Task<int> Sync(Guid entryId,
             return 1;
         };
         Func<IMiniLcmApi, ExampleSentence, ExampleSentence, Task<int>> replace =
-            async (api, beforeExampleSentence, afterExampleSentence) =>
-            {
-                var updateObjectInput = DiffToUpdate(beforeExampleSentence, afterExampleSentence);
-                if (updateObjectInput is null) return 0;
-                await api.UpdateExampleSentence(entryId, senseId, beforeExampleSentence.Id, updateObjectInput);
-                return 1;
-            };
+            (api, beforeExampleSentence, afterExampleSentence) =>
+                Sync(entryId, senseId, afterExampleSentence, beforeExampleSentence, api);
         return await DiffCollection.Diff(api,
             beforeExampleSentences,
             afterExampleSentences,
@@ -37,6 +32,18 @@ public static async Task<int> Sync(Guid entryId,
             replace);
     }
 
+    public static async Task<int> Sync(Guid entryId,
+        Guid senseId,
+        ExampleSentence afterExampleSentence,
+        ExampleSentence beforeExampleSentence,
+        IMiniLcmApi api)
+    {
+        var updateObjectInput = DiffToUpdate(beforeExampleSentence, afterExampleSentence);
+        if (updateObjectInput is null) return 0;
+        await api.UpdateExampleSentence(entryId, senseId, beforeExampleSentence.Id, updateObjectInput);
+        return 1;
+    }
+
     public static UpdateObjectInput<ExampleSentence>? DiffToUpdate(ExampleSentence beforeExampleSentence,
         ExampleSentence afterExampleSentence)
     {

backend/LfClassicData/LfClassicMiniLcmApi.cs

@@ -314,4 +314,15 @@ private static SemanticDomain ToSemanticDomain(Entities.OptionListItem item)
         if (entry is null) return null;
         return ToEntry(entry);
     }
+
+    public async Task<ExampleSentence?> GetExampleSentence(Guid entryId, Guid senseId, Guid id)
+    {
+        var entry = await Entries.Find(e => e.Guid == entryId).FirstOrDefaultAsync();
+        if (entry is null) return null;
+        var sense = entry.Senses?.FirstOrDefault(s => s?.Guid == senseId);
+        if (sense is null) return null;
+        var exampleSentence = sense.Examples?.FirstOrDefault(e => e?.Guid == id);
+        if (exampleSentence is null) return null;
+        return ToExampleSentence(sense.Guid, exampleSentence);
+    }
 }