Add sharding passivate-idle-entity-after property (#290)

Author: Arkatufus

src/Akka.Cluster.Hosting/AkkaClusterHostingExtensions.cs

@@ -278,12 +278,21 @@ public sealed class ShardOptions
         ///     <see cref="Akka.Cluster.Sharding.StateStoreMode.DData"/>
         /// </summary>
         public ShardingDDataOptions DistributedData { get; } = new();
+
+        /// <summary>
+        /// Set this to a time duration to have sharding passivate entities when they have not
+        /// received any message in this length of time. Set to <c>null</c> to disable.
+        /// It is always disabled if <see cref="RememberEntities"/> is enabled.
+        /// </summary>
+        // Had to do it this way because this property is a tri-state
+        public TimeSpan? PassivateIdleEntityAfter { get; set; } = TimeSpan.FromMinutes(2);
 
         internal void Apply(AkkaConfigurationBuilder builder)
         {
             DistributedData.Apply(builder);
 
             var sb = new StringBuilder();
+            sb.AppendLine("akka.cluster.sharding {");
 
             if (Role is { })
                 sb.AppendLine($"role = {Role.ToHocon()}");
@@ -315,10 +324,10 @@ internal void Apply(AkkaConfigurationBuilder builder)
                 sb.AppendLine(
                     $"fail-on-invalid-entity-state-transition = {FailOnInvalidEntityStateTransition.ToHocon()}");
 
-            if(sb.Length == 0)
-                return;
+            // Had to do it this way because this property is a tri-state
+            sb.AppendLine(
+                $"passivate-idle-entity-after = {(PassivateIdleEntityAfter is null ? "off" : PassivateIdleEntityAfter.ToHocon())}");
 
-            sb.Insert(0, "akka.cluster.sharding {");
             sb.AppendLine("}");
             builder.AddHocon(sb.ToString(), HoconAddMode.Prepend);
         }

src/Akka.Hosting.API.Tests/verify/CoreApiSpec.ApproveCluster.verified.txt

@@ -77,6 +77,7 @@ namespace Akka.Cluster.Hosting
         public string? JournalPluginId { get; set; }
         public Akka.Hosting.Coordination.LeaseOptionBase? LeaseImplementation { get; set; }
         public System.TimeSpan? LeaseRetryInterval { get; set; }
+        public System.TimeSpan? PassivateIdleEntityAfter { get; set; }
         public bool? RememberEntities { get; set; }
         public Akka.Cluster.Sharding.RememberEntitiesStore? RememberEntitiesStore { get; set; }
         public string? Role { get; set; }