Complete server coverage. (#31)

* (#28) Guards moved to new library; reorg of test libraries to compensate for naming.
* (#28) Full test coverage (including live tests) for server.
* Updated library list for GitHub Actions releases

Author: adrianhall

.github/workflows/SignedPackageFileList.txt

@@ -1,7 +1,7 @@
+**/CommunityToolkit.Datasync.Common
 **/CommunityToolkit.Datasync.Server
 **/CommunityToolkit.Datasync.Server.Abstractions
 **/CommunityToolkit.Datasync.Server.Automapper
 **/CommunityToolkit.Datasync.Server.EntityFrameworkCore
 **/CommunityToolkit.Datasync.Server.InMemory
 **/CommunityToolkit.Datasync.Server.LiteDb
-**/CommunityToolkit.Datasync.Client

src/CommunityToolkit.Datasync.Common/Guards/ParamExtensions.cs

@@ -69,24 +69,6 @@ public static Param<Uri> IsAbsoluteUri(this Param<Uri> param, string? because =
         return param;
     }
 
-    /// <summary>
-    /// Guards against a string not being a valid Id.
-    /// </summary>
-    /// <param name="param">The parameter to check.</param>
-    /// <param name="because">A reason to use instead of the default reason.</param>
-    /// <returns>The parameter (for chaining)</returns>
-    /// <exception cref="ArgumentException">Thrown if the ID is not valid.</exception>
-    public static Param<string> IsAValidId(this Param<string> param, string? because = null)
-    {
-        if (!RegexpConstants.EntityIdentity.IsMatch(param.Value))
-        {
-            because ??= $"The parameter '{param.Name}' must be a valid Id";
-            throw new ArgumentException(because, param.Name);
-        }
-
-        return param;
-    }
-
     /// <summary>
     /// Guards against invalid datasync service endpoint URIs.
     /// </summary>
@@ -248,6 +230,24 @@ public static Param<string> IsNotNullOrWhiteSpace(this Param<string> param, stri
         return param;
     }
 
+    /// <summary>
+    /// Guards against a string not being a valid Id.
+    /// </summary>
+    /// <param name="param">The parameter to check.</param>
+    /// <param name="because">A reason to use instead of the default reason.</param>
+    /// <returns>The parameter (for chaining)</returns>
+    /// <exception cref="ArgumentException">Thrown if the ID is not valid.</exception>
+    public static Param<string> IsValidId(this Param<string> param, string? because = null)
+    {
+        if (!RegexpConstants.EntityIdentity.IsMatch(param.Value))
+        {
+            because ??= $"The parameter '{param.Name}' must be a valid Id";
+            throw new ArgumentException(because, param.Name);
+        }
+
+        return param;
+    }
+
     /// <summary>
     /// Checks to ensure that the provided string parameter matches a provided regular expression.
     /// </summary>

src/CommunityToolkit.Datasync.Server.EntityFrameworkCore/RepositoryControlledEntityTableData.cs

@@ -0,0 +1,21 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+namespace CommunityToolkit.Datasync.Server.EntityFrameworkCore;
+
+/// <summary>
+/// A version of the <see cref="BaseEntityTableData"/> that updates both the
+/// <c>UpdatedAt</c> and <c>Version</c> fields within the repository (instead
+/// of relying on the database server to do it).
+/// </summary>
+public class RepositoryControlledEntityTableData : BaseEntityTableData
+{
+    /// <inheritdoc />
+    [UpdatedByRepository]
+    public override DateTimeOffset? UpdatedAt { get; set; } = DateTimeOffset.UnixEpoch;
+
+    /// <inheritdoc />
+    [UpdatedByRepository]
+    public override byte[] Version { get; set; } = [];
+}

tests/CommunityToolkit.Datasync.Common.Test/CommunityToolkit.Datasync.Common.Test.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <Import Project="..\Shared.Build.props" />
   <ItemGroup>
     <ProjectReference Include="..\..\src\CommunityToolkit.Datasync.Common\CommunityToolkit.Datasync.Common.csproj" />

tests/CommunityToolkit.Datasync.Common.Test/Ensure_Tests.cs

@@ -0,0 +1,34 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using CommunityToolkit.Datasync.TestCommon.Models;
+
+using TestData = CommunityToolkit.Datasync.TestCommon.TestData;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace CommunityToolkit.Datasync.Common.Test.Extensions;
+
+[ExcludeFromCodeCoverage]
+public class Clone_Tests
+{
+    [Fact]
+    public void Clone_Null_Works()
+    {
+        object obj = null;
+        object result = obj.Clone();
+        result.Should().BeNull();
+    }
+
+    [Fact]
+    public void Clone_Works()
+    {
+        MovieBase sut = TestData.Movies.BlackPanther;
+        MovieBase b = sut.Clone();
+        b.Should().NotBeSameAs(sut).And.BeEquivalentTo(sut);
+    }
+}