feat(#367,#368,#369): JasperFx.Events 2.36.1 — classified shard failures, widened natural key contract, drain-timeout docs - #371

Using member 'System.Text.Json.JsonSerializer.Serialize<TValue>(TValue, JsonSerializerOptions)' which has 'RequiresUnreferencedCodeAttribute' can break functionality when trimming application code. JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.

Using member 'Polecat.DocumentStore.ResolveEventClrType(String)' which has 'RequiresUnreferencedCodeAttribute' can break functionality when trimming application code. Walks AppDomain.GetAssemblies() + Assembly.GetTypes() to resolve eventTypeName → CLR Type. The trimmer cannot reason about which event types survive; AOT-publishing apps should register event types explicitly via EventGraph.AddEventType or use the source-generated event registry.

Using member 'Polecat.DocumentStore.ToDomainEvent(EventRecord)' which has 'RequiresUnreferencedCodeAttribute' can break functionality when trimming application code. Walks loaded assemblies to resolve eventTypeName → CLR Type and routes through ISerializer.FromJson which is annotated

Using member 'Polecat.DocumentStore.RunProjectionForReferenceTypeAsync<TState>(IReadOnlyList<EventRecord>, TState, CancellationToken)' which has 'RequiresUnreferencedCodeAttribute' can break functionality when trimming application code. Routes projection events through the aggregator graph + ToDomainEvent reflective deserialization. TState's public members must survive trimming for the aggregator to access them.

Ambiguous reference in cref attribute: 'JsonIndex'. Assuming 'Polecat.Storage.DocumentMappingExpression<T>.JsonIndex(System.Linq.Expressions.Expression<System.Func<T, object?>>, System.Action<Polecat.Storage.JsonIndex>?)', but could have also matched other overloads including 'Polecat.Storage.DocumentMappingExpression<T>.JsonIndex(System.Action<Polecat.Storage.JsonIndex>?)'.

XML comment on 'RecordProgressionOperation' has a paramref tag for 'upsert', but there is no parameter by that name

Possible null reference assignment.

Possible null reference assignment.

Possible null reference assignment.