2026-05-06 11:50:10 +01:00
|
|
|
using System;
|
|
|
|
|
using System.Collections.Generic;
|
|
|
|
|
using System.Globalization;
|
|
|
|
|
using System.Linq;
|
|
|
|
|
using System.Threading.Tasks;
|
|
|
|
|
using GameCult.Caching;
|
|
|
|
|
using GameCult.Caching.MessagePack;
|
2026-06-27 21:12:05 +01:00
|
|
|
using MessagePack;
|
2026-05-06 11:50:10 +01:00
|
|
|
|
|
|
|
|
namespace GameCult.Networking
|
|
|
|
|
{
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Optional metadata applied when creating CultNet document messages.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public sealed class CultNetDocumentMessageOptions
|
|
|
|
|
{
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets or sets an explicit storage timestamp.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public string? StoredAt { get; set; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets or sets the runtime that produced the document.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public string? SourceRuntimeId { get; set; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets or sets the agent that produced the document.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public string? SourceAgentId { get; set; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets or sets the role that produced the document.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public string? SourceRole { get; set; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets or sets optional document tags.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public string[]? Tags { get; set; }
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Binds a CultCache document type to CultNet payload serialization.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public sealed class CultNetDocumentBinding
|
|
|
|
|
{
|
|
|
|
|
internal CultNetDocumentBinding(
|
2026-05-08 01:13:15 +01:00
|
|
|
Type documentType,
|
|
|
|
|
string schemaId,
|
|
|
|
|
Func<object, byte[]> payloadSerializer,
|
|
|
|
|
Func<byte[], object> payloadDeserializer)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
DocumentType = documentType;
|
|
|
|
|
SchemaId = schemaId;
|
|
|
|
|
PayloadSerializer = payloadSerializer;
|
|
|
|
|
PayloadDeserializer = payloadDeserializer;
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the bound document type.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public Type DocumentType { get; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the bound schema identifier.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public string SchemaId { get; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the payload serializer.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public Func<object, byte[]> PayloadSerializer { get; }
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the payload deserializer.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public Func<byte[], object> PayloadDeserializer { get; }
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a document binding for a typed CultCache document.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public static CultNetDocumentBinding ForDocument<T>(
|
|
|
|
|
CultDocumentRegistry? registry = null,
|
2026-05-16 09:16:43 +01:00
|
|
|
string? schemaId = null,
|
2026-05-06 11:50:10 +01:00
|
|
|
Func<T, byte[]>? payloadSerializer = null,
|
|
|
|
|
Func<byte[], T>? payloadDeserializer = null)
|
2026-05-08 01:13:15 +01:00
|
|
|
where T : class
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
Make generated and reflective document members one rule
The generator and CultDocumentRegistry now discover members by the same
steps: most-derived declaration first, override chain collapsed to one
member, attributes read up the override chain, rejections in one order
with one text (GCC001 / InvalidOperationException).
- Accessors are named per document, so documents sharing a [CultName] or
[CultIndex] base member no longer emit duplicate methods (CS0111).
- Duplicate [Key] slots are refused, including new-hidden fields and
properties; a hidden persisted member with a different slot is refused.
- String [Key("x")] gets its own message instead of "has no [Key]".
- A persisted property whose set accessor is private, protected or init,
or a readonly field, is refused instead of CS0272 in generated code.
- Overrides: MessagePack's DynamicObjectResolver reads the base
declaration's [Key]/[IgnoreMember] (it throws "key is duplicated" for a
re-keyed override and serializes an override marked [IgnoreMember]).
An override that changes them is refused in both paths; an override
that repeats or omits them is accepted and byte-pinned.
- Typed Serialize<T>/Deserialize<T> used static Options and skipped
generated codecs and declared resolvers; deleted. CultNetDocumentBinding
and CultMeshSnapshots route through the untyped path with their registry.
DocumentShapeSweepTests compiles each shape through the generator and
compares generated vs reflective schema id, catalog, name/index values
and payload against MessagePack's own bytes, or equal rejection text.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 22:00:16 +02:00
|
|
|
var documents = registry ?? CultDocumentRegistry.Shared;
|
|
|
|
|
var descriptor = documents.GetRequired<T>();
|
2026-05-06 11:50:10 +01:00
|
|
|
return new CultNetDocumentBinding(
|
|
|
|
|
typeof(T),
|
2026-05-16 09:16:43 +01:00
|
|
|
string.IsNullOrWhiteSpace(schemaId) ? descriptor.SchemaId : schemaId!,
|
2026-05-08 01:13:15 +01:00
|
|
|
document =>
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
var typed = (T)document;
|
2026-05-06 11:50:10 +01:00
|
|
|
return payloadSerializer != null
|
2026-05-08 01:13:15 +01:00
|
|
|
? payloadSerializer(typed)
|
Make generated and reflective document members one rule
The generator and CultDocumentRegistry now discover members by the same
steps: most-derived declaration first, override chain collapsed to one
member, attributes read up the override chain, rejections in one order
with one text (GCC001 / InvalidOperationException).
- Accessors are named per document, so documents sharing a [CultName] or
[CultIndex] base member no longer emit duplicate methods (CS0111).
- Duplicate [Key] slots are refused, including new-hidden fields and
properties; a hidden persisted member with a different slot is refused.
- String [Key("x")] gets its own message instead of "has no [Key]".
- A persisted property whose set accessor is private, protected or init,
or a readonly field, is refused instead of CS0272 in generated code.
- Overrides: MessagePack's DynamicObjectResolver reads the base
declaration's [Key]/[IgnoreMember] (it throws "key is duplicated" for a
re-keyed override and serializes an override marked [IgnoreMember]).
An override that changes them is refused in both paths; an override
that repeats or omits them is accepted and byte-pinned.
- Typed Serialize<T>/Deserialize<T> used static Options and skipped
generated codecs and declared resolvers; deleted. CultNetDocumentBinding
and CultMeshSnapshots route through the untyped path with their registry.
DocumentShapeSweepTests compiles each shape through the generator and
compares generated vs reflective schema id, catalog, name/index values
and payload against MessagePack's own bytes, or equal rejection text.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 22:00:16 +02:00
|
|
|
: CultDocumentMessagePackSerialization.SerializeUntyped(typed, typeof(T), documents);
|
2026-05-06 11:50:10 +01:00
|
|
|
},
|
|
|
|
|
payload => payloadDeserializer != null
|
|
|
|
|
? payloadDeserializer(payload)
|
Make generated and reflective document members one rule
The generator and CultDocumentRegistry now discover members by the same
steps: most-derived declaration first, override chain collapsed to one
member, attributes read up the override chain, rejections in one order
with one text (GCC001 / InvalidOperationException).
- Accessors are named per document, so documents sharing a [CultName] or
[CultIndex] base member no longer emit duplicate methods (CS0111).
- Duplicate [Key] slots are refused, including new-hidden fields and
properties; a hidden persisted member with a different slot is refused.
- String [Key("x")] gets its own message instead of "has no [Key]".
- A persisted property whose set accessor is private, protected or init,
or a readonly field, is refused instead of CS0272 in generated code.
- Overrides: MessagePack's DynamicObjectResolver reads the base
declaration's [Key]/[IgnoreMember] (it throws "key is duplicated" for a
re-keyed override and serializes an override marked [IgnoreMember]).
An override that changes them is refused in both paths; an override
that repeats or omits them is accepted and byte-pinned.
- Typed Serialize<T>/Deserialize<T> used static Options and skipped
generated codecs and declared resolvers; deleted. CultNetDocumentBinding
and CultMeshSnapshots route through the untyped path with their registry.
DocumentShapeSweepTests compiles each shape through the generator and
compares generated vs reflective schema id, catalog, name/index values
and payload against MessagePack's own bytes, or equal rejection text.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 22:00:16 +02:00
|
|
|
: (T)CultDocumentMessagePackSerialization.DeserializeUntyped(typeof(T), payload, documents));
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
2026-06-27 18:01:12 +01:00
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a document binding for a CultCache document type discovered at runtime.
|
|
|
|
|
/// </summary>
|
|
|
|
|
public static CultNetDocumentBinding ForDocument(
|
|
|
|
|
Type documentType,
|
|
|
|
|
CultDocumentRegistry? registry = null,
|
|
|
|
|
string? schemaId = null,
|
|
|
|
|
Func<object, byte[]>? payloadSerializer = null,
|
|
|
|
|
Func<byte[], object>? payloadDeserializer = null)
|
|
|
|
|
{
|
|
|
|
|
if (documentType == null)
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentNullException(nameof(documentType));
|
|
|
|
|
}
|
|
|
|
|
|
Make generated and reflective document members one rule
The generator and CultDocumentRegistry now discover members by the same
steps: most-derived declaration first, override chain collapsed to one
member, attributes read up the override chain, rejections in one order
with one text (GCC001 / InvalidOperationException).
- Accessors are named per document, so documents sharing a [CultName] or
[CultIndex] base member no longer emit duplicate methods (CS0111).
- Duplicate [Key] slots are refused, including new-hidden fields and
properties; a hidden persisted member with a different slot is refused.
- String [Key("x")] gets its own message instead of "has no [Key]".
- A persisted property whose set accessor is private, protected or init,
or a readonly field, is refused instead of CS0272 in generated code.
- Overrides: MessagePack's DynamicObjectResolver reads the base
declaration's [Key]/[IgnoreMember] (it throws "key is duplicated" for a
re-keyed override and serializes an override marked [IgnoreMember]).
An override that changes them is refused in both paths; an override
that repeats or omits them is accepted and byte-pinned.
- Typed Serialize<T>/Deserialize<T> used static Options and skipped
generated codecs and declared resolvers; deleted. CultNetDocumentBinding
and CultMeshSnapshots route through the untyped path with their registry.
DocumentShapeSweepTests compiles each shape through the generator and
compares generated vs reflective schema id, catalog, name/index values
and payload against MessagePack's own bytes, or equal rejection text.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 22:00:16 +02:00
|
|
|
var documents = registry ?? CultDocumentRegistry.Shared;
|
|
|
|
|
var descriptor = documents.GetRequired(documentType);
|
2026-06-27 18:01:12 +01:00
|
|
|
return new CultNetDocumentBinding(
|
|
|
|
|
documentType,
|
|
|
|
|
string.IsNullOrWhiteSpace(schemaId) ? descriptor.SchemaId : schemaId!,
|
|
|
|
|
document =>
|
|
|
|
|
{
|
|
|
|
|
if (!documentType.IsInstanceOfType(document))
|
|
|
|
|
{
|
|
|
|
|
throw new InvalidOperationException(
|
|
|
|
|
$"Document payload type {document.GetType().FullName} is not assignable to {documentType.FullName}.");
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return payloadSerializer != null
|
|
|
|
|
? payloadSerializer(document)
|
Make generated and reflective document members one rule
The generator and CultDocumentRegistry now discover members by the same
steps: most-derived declaration first, override chain collapsed to one
member, attributes read up the override chain, rejections in one order
with one text (GCC001 / InvalidOperationException).
- Accessors are named per document, so documents sharing a [CultName] or
[CultIndex] base member no longer emit duplicate methods (CS0111).
- Duplicate [Key] slots are refused, including new-hidden fields and
properties; a hidden persisted member with a different slot is refused.
- String [Key("x")] gets its own message instead of "has no [Key]".
- A persisted property whose set accessor is private, protected or init,
or a readonly field, is refused instead of CS0272 in generated code.
- Overrides: MessagePack's DynamicObjectResolver reads the base
declaration's [Key]/[IgnoreMember] (it throws "key is duplicated" for a
re-keyed override and serializes an override marked [IgnoreMember]).
An override that changes them is refused in both paths; an override
that repeats or omits them is accepted and byte-pinned.
- Typed Serialize<T>/Deserialize<T> used static Options and skipped
generated codecs and declared resolvers; deleted. CultNetDocumentBinding
and CultMeshSnapshots route through the untyped path with their registry.
DocumentShapeSweepTests compiles each shape through the generator and
compares generated vs reflective schema id, catalog, name/index values
and payload against MessagePack's own bytes, or equal rejection text.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 22:00:16 +02:00
|
|
|
: CultDocumentMessagePackSerialization.SerializeUntyped(document, documentType, documents);
|
2026-06-27 18:01:12 +01:00
|
|
|
},
|
|
|
|
|
payload => payloadDeserializer != null
|
|
|
|
|
? payloadDeserializer(payload)
|
Make generated and reflective document members one rule
The generator and CultDocumentRegistry now discover members by the same
steps: most-derived declaration first, override chain collapsed to one
member, attributes read up the override chain, rejections in one order
with one text (GCC001 / InvalidOperationException).
- Accessors are named per document, so documents sharing a [CultName] or
[CultIndex] base member no longer emit duplicate methods (CS0111).
- Duplicate [Key] slots are refused, including new-hidden fields and
properties; a hidden persisted member with a different slot is refused.
- String [Key("x")] gets its own message instead of "has no [Key]".
- A persisted property whose set accessor is private, protected or init,
or a readonly field, is refused instead of CS0272 in generated code.
- Overrides: MessagePack's DynamicObjectResolver reads the base
declaration's [Key]/[IgnoreMember] (it throws "key is duplicated" for a
re-keyed override and serializes an override marked [IgnoreMember]).
An override that changes them is refused in both paths; an override
that repeats or omits them is accepted and byte-pinned.
- Typed Serialize<T>/Deserialize<T> used static Options and skipped
generated codecs and declared resolvers; deleted. CultNetDocumentBinding
and CultMeshSnapshots route through the untyped path with their registry.
DocumentShapeSweepTests compiles each shape through the generator and
compares generated vs reflective schema id, catalog, name/index values
and payload against MessagePack's own bytes, or equal rejection text.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 22:00:16 +02:00
|
|
|
: CultDocumentMessagePackSerialization.DeserializeUntyped(documentType, payload, documents));
|
2026-06-27 18:01:12 +01:00
|
|
|
}
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Creates and applies CultNet messages that replicate CultCache documents.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public sealed class CultNetDocumentRegistry
|
|
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
private readonly CultDocumentRegistry _documents;
|
|
|
|
|
private readonly Dictionary<string, CultNetDocumentBinding> _bindingsBySchemaId =
|
|
|
|
|
new(StringComparer.Ordinal);
|
|
|
|
|
private readonly Dictionary<Type, CultNetDocumentBinding> _bindingsByType = new();
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a document registry with optional bindings.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public CultNetDocumentRegistry(
|
|
|
|
|
CultDocumentRegistry? documents = null,
|
|
|
|
|
IEnumerable<CultNetDocumentBinding>? bindings = null)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
_documents = documents ?? CultDocumentRegistry.Shared;
|
2026-05-06 11:50:10 +01:00
|
|
|
if (bindings == null)
|
|
|
|
|
{
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
foreach (var binding in bindings)
|
|
|
|
|
{
|
|
|
|
|
Register(binding);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Registers a document binding.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public CultNetDocumentRegistry Register(CultNetDocumentBinding binding)
|
|
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
_bindingsBySchemaId[binding.SchemaId] = binding;
|
|
|
|
|
_bindingsByType[binding.DocumentType] = binding;
|
2026-05-06 11:50:10 +01:00
|
|
|
return this;
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets a binding by schema identifier.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public CultNetDocumentBinding? GetBySchemaId(string schemaId)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
return _bindingsBySchemaId.TryGetValue(schemaId, out var binding) ? binding : null;
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Gets a binding by CLR document type.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public CultNetDocumentBinding? GetByDocumentType(Type documentType)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
return _bindingsByType.TryGetValue(documentType, out var binding) ? binding : null;
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a document delete message.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public CultNetDocumentDeleteMessage CreateDocumentDeleteMessage(
|
|
|
|
|
string messageId,
|
2026-05-08 01:13:15 +01:00
|
|
|
string schemaId,
|
|
|
|
|
string recordKey)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
|
|
|
|
return new CultNetDocumentDeleteMessage
|
|
|
|
|
{
|
|
|
|
|
MessageId = RequireNonEmpty(messageId, nameof(messageId)),
|
2026-05-08 01:13:15 +01:00
|
|
|
SchemaId = RequireNonEmpty(schemaId, nameof(schemaId)),
|
|
|
|
|
RecordKey = RequireNonEmpty(recordKey, nameof(recordKey))
|
2026-05-06 11:50:10 +01:00
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a raw document put message for a typed document.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public CultNetDocumentPutRawMessage CreateRawDocumentPutMessage<T>(
|
2026-05-06 11:50:10 +01:00
|
|
|
string messageId,
|
2026-05-08 01:13:15 +01:00
|
|
|
CultRecordHandle<T> handle,
|
|
|
|
|
T document,
|
2026-05-06 11:50:10 +01:00
|
|
|
CultNetDocumentMessageOptions? options = null)
|
2026-05-08 01:13:15 +01:00
|
|
|
where T : class
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
var descriptor = _documents.GetRequired<T>();
|
|
|
|
|
var binding = GetByDocumentType(typeof(T)) ?? CultNetDocumentBinding.ForDocument<T>(_documents);
|
2026-05-06 11:50:10 +01:00
|
|
|
var storedAt = ResolveStoredAt(options);
|
|
|
|
|
|
|
|
|
|
return new CultNetDocumentPutRawMessage
|
|
|
|
|
{
|
|
|
|
|
MessageId = RequireNonEmpty(messageId, nameof(messageId)),
|
|
|
|
|
Document = new CultNetRawDocumentRecord
|
|
|
|
|
{
|
2026-05-16 09:16:43 +01:00
|
|
|
SchemaId = binding.SchemaId,
|
2026-08-18 02:08:49 +02:00
|
|
|
SchemaName = descriptor.SchemaName,
|
|
|
|
|
SchemaVersion = descriptor.SchemaVersion,
|
|
|
|
|
SchemaContentHash = descriptor.ContentHash,
|
2026-05-08 01:13:15 +01:00
|
|
|
RecordKey = handle.Key.Value,
|
|
|
|
|
StoredAt = storedAt,
|
2026-05-06 11:50:10 +01:00
|
|
|
PayloadEncoding = "messagepack",
|
2026-05-08 01:13:15 +01:00
|
|
|
Payload = binding.PayloadSerializer(document),
|
|
|
|
|
SourceRuntimeId = options?.SourceRuntimeId,
|
|
|
|
|
SourceAgentId = options?.SourceAgentId,
|
|
|
|
|
SourceRole = options?.SourceRole,
|
|
|
|
|
Tags = options?.Tags
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a snapshot request message.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public CultNetSnapshotRequestMessage CreateSnapshotRequest(
|
|
|
|
|
string messageId,
|
2026-05-08 01:13:15 +01:00
|
|
|
IEnumerable<string>? schemaIds = null,
|
|
|
|
|
IEnumerable<string>? recordKeys = null)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
|
|
|
|
return new CultNetSnapshotRequestMessage
|
|
|
|
|
{
|
|
|
|
|
MessageId = RequireNonEmpty(messageId, nameof(messageId)),
|
2026-05-08 01:13:15 +01:00
|
|
|
SchemaIds = schemaIds?.ToArray(),
|
|
|
|
|
RecordKeys = recordKeys?.ToArray()
|
2026-05-06 11:50:10 +01:00
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
/// Creates a typed-selection snapshot request message (docs/cultnet-selection-cut.md).
|
|
|
|
|
/// </summary>
|
|
|
|
|
public CultNetSnapshotRequestV1Message CreateSnapshotRequestV1(string messageId, CultNetSelection selection)
|
|
|
|
|
{
|
|
|
|
|
if (selection == null) throw new ArgumentNullException(nameof(selection));
|
|
|
|
|
return new CultNetSnapshotRequestV1Message
|
|
|
|
|
{
|
|
|
|
|
MessageId = RequireNonEmpty(messageId, nameof(messageId)),
|
|
|
|
|
Selection = selection
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Creates a raw snapshot response from the cache. v0 has no selector engine of its own
|
|
|
|
|
/// (docs/cultnet-selection-cut.md, D3/D4): the filter lowers into a <see cref="CultNetSelection"/>
|
|
|
|
|
/// and is answered by <see cref="CultNetSelectionEvaluator"/>, walking every page it returns so a
|
|
|
|
|
/// v0 caller still sees its whole matching set in one message.
|
2026-05-08 13:11:01 +01:00
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public CultNetSnapshotResponseRawMessage CreateRawSnapshotResponse(
|
|
|
|
|
CultCache cache,
|
|
|
|
|
string messageId,
|
|
|
|
|
CultNetSnapshotRequestMessage? filter = null,
|
|
|
|
|
CultNetDocumentMessageOptions? options = null)
|
|
|
|
|
{
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
if (cache == null) throw new ArgumentNullException(nameof(cache));
|
|
|
|
|
var selection = new CultNetSelection
|
|
|
|
|
{
|
|
|
|
|
Schemas = filter?.SchemaIds,
|
|
|
|
|
Keys = filter?.RecordKeys,
|
|
|
|
|
Projection = CultNetSelectionProjections.Document,
|
|
|
|
|
Limit = CultNetSelectionEvaluator.LimitMax
|
|
|
|
|
};
|
2026-05-06 11:50:10 +01:00
|
|
|
|
|
|
|
|
var documents = new List<CultNetRawDocumentRecord>();
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
string? cursor = null;
|
|
|
|
|
do
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
selection.Cursor = cursor;
|
|
|
|
|
var page = SelectPage(cache, selection, ordinalOf: static (_, _) => 0, asOf: 0, validate: false, options);
|
|
|
|
|
documents.AddRange(page.Documents ?? Array.Empty<CultNetRawDocumentRecord>());
|
|
|
|
|
cursor = page.Next;
|
|
|
|
|
} while (cursor != null);
|
2026-05-06 11:50:10 +01:00
|
|
|
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
return new CultNetSnapshotResponseRawMessage
|
|
|
|
|
{
|
|
|
|
|
MessageId = RequireNonEmpty(messageId, nameof(messageId)),
|
|
|
|
|
Documents = documents.ToArray()
|
|
|
|
|
};
|
|
|
|
|
}
|
2026-05-06 11:50:10 +01:00
|
|
|
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
/// <summary>
|
|
|
|
|
/// Evaluates a typed selection against the cache and returns its page
|
|
|
|
|
/// (docs/cultnet-selection-cut.md, section 2/6). <paramref name="ordinalOf"/> supplies each
|
|
|
|
|
/// row's ordinal (the reference: <see cref="CultNetDatabase.LastWriteSequence"/>); <paramref name="asOf"/>
|
|
|
|
|
/// is the snapshot the page is exact for.
|
|
|
|
|
/// </summary>
|
|
|
|
|
public CultNetSnapshotResponseRawV1Message CreateSelectionResponse(
|
|
|
|
|
CultCache cache,
|
|
|
|
|
string messageId,
|
|
|
|
|
CultNetSelection selection,
|
|
|
|
|
Func<string, CultRecordKey, long> ordinalOf,
|
|
|
|
|
ulong asOf,
|
|
|
|
|
CultNetDocumentMessageOptions? options = null)
|
|
|
|
|
{
|
|
|
|
|
if (cache == null) throw new ArgumentNullException(nameof(cache));
|
|
|
|
|
if (selection == null) throw new ArgumentNullException(nameof(selection));
|
|
|
|
|
if (ordinalOf == null) throw new ArgumentNullException(nameof(ordinalOf));
|
|
|
|
|
|
|
|
|
|
var page = SelectPage(cache, selection, ordinalOf, asOf, validate: true, options);
|
|
|
|
|
return new CultNetSnapshotResponseRawV1Message
|
2026-07-12 08:42:08 +01:00
|
|
|
{
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
MessageId = RequireNonEmpty(messageId, nameof(messageId)),
|
|
|
|
|
Matched = page.Matched,
|
|
|
|
|
AsOf = page.AsOf,
|
|
|
|
|
Next = page.Next,
|
|
|
|
|
Headers = page.Headers,
|
|
|
|
|
Documents = page.Documents,
|
|
|
|
|
Edges = page.Edges
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Evaluates a selection over every row the cache holds and projects the matched page to wire
|
|
|
|
|
/// records. The one evaluator (<see cref="CultNetSelectionEvaluator"/>) owns matching, order,
|
|
|
|
|
/// the hop and the cursor; this owns turning its result into <see cref="CultNetRawDocumentRecord"/>s.
|
|
|
|
|
/// </summary>
|
|
|
|
|
internal CultNetSelectionPage SelectPage(
|
|
|
|
|
CultCache cache,
|
|
|
|
|
CultNetSelection selection,
|
|
|
|
|
Func<string, CultRecordKey, long> ordinalOf,
|
|
|
|
|
ulong asOf,
|
|
|
|
|
bool validate,
|
|
|
|
|
CultNetDocumentMessageOptions? options)
|
|
|
|
|
{
|
|
|
|
|
selection = ExpandSchemaBindingAliases(selection);
|
|
|
|
|
if (validate)
|
|
|
|
|
selection.Validate(_documents.AllDescriptors.ToArray());
|
|
|
|
|
|
|
|
|
|
var rows = cache.AllStoredDocuments
|
|
|
|
|
.Select(stored => new CultNetSelectionEvaluator.Row(
|
|
|
|
|
stored.Descriptor, stored.Key, stored.Document, ordinalOf(stored.Descriptor.SchemaId, stored.Key), stored.StoredAt))
|
|
|
|
|
.ToArray();
|
|
|
|
|
var evaluation = CultNetSelectionEvaluator.Select(_documents, rows, selection, asOf);
|
|
|
|
|
var records = evaluation.Rows.Select(row => ToRawRecord(row, options)).ToArray();
|
|
|
|
|
var wantDocument = selection.Projection == CultNetSelectionProjections.Document;
|
|
|
|
|
|
|
|
|
|
return new CultNetSelectionPage
|
2026-07-12 08:42:08 +01:00
|
|
|
{
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
Matched = (uint)records.Length,
|
|
|
|
|
AsOf = asOf,
|
|
|
|
|
Next = evaluation.NextCursor,
|
|
|
|
|
Documents = wantDocument ? records : null,
|
|
|
|
|
Headers = wantDocument ? null : records.Select(CultNetRawDocumentHeader.FromRecord).ToArray(),
|
|
|
|
|
Edges = selection.HasHop ? evaluation.Edges.Select(edge => ToEdge(edge, wantDocument)).ToArray() : null
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// A CultDocumentDescriptor knows nothing of CultNetDocumentBinding's optional schema-id
|
|
|
|
|
// override; a caller filtering by that wire id (rather than the descriptor's own) needs the
|
|
|
|
|
// descriptor's own id present in the selection too, since CultNetSelectionEvaluator only ever
|
|
|
|
|
// reads descriptors. Mirrors CultNetSchemaAliasMatching.WithBindingSchemaAlias, at the layer
|
|
|
|
|
// that owns every binding rather than one row's.
|
|
|
|
|
private CultNetSelection ExpandSchemaBindingAliases(CultNetSelection selection)
|
|
|
|
|
{
|
|
|
|
|
if (selection.Schemas is not { Length: > 0 } || _bindingsByType.Count == 0)
|
|
|
|
|
return selection;
|
|
|
|
|
|
|
|
|
|
List<string>? expanded = null;
|
|
|
|
|
foreach (var binding in _bindingsByType.Values)
|
|
|
|
|
{
|
|
|
|
|
if (!selection.Schemas.Contains(binding.SchemaId, StringComparer.Ordinal))
|
|
|
|
|
continue;
|
|
|
|
|
var descriptor = _documents.GetRequired(binding.DocumentType);
|
|
|
|
|
if (selection.Schemas.Contains(descriptor.SchemaId, StringComparer.Ordinal))
|
|
|
|
|
continue;
|
|
|
|
|
expanded ??= new List<string>(selection.Schemas);
|
|
|
|
|
if (!expanded.Contains(descriptor.SchemaId, StringComparer.Ordinal))
|
|
|
|
|
expanded.Add(descriptor.SchemaId);
|
2026-07-12 08:42:08 +01:00
|
|
|
}
|
|
|
|
|
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
if (expanded == null)
|
|
|
|
|
return selection;
|
|
|
|
|
|
|
|
|
|
return new CultNetSelection
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
Schemas = expanded.ToArray(),
|
|
|
|
|
Keys = selection.Keys,
|
|
|
|
|
Fields = selection.Fields,
|
|
|
|
|
Cites = selection.Cites,
|
|
|
|
|
Cited = selection.Cited,
|
|
|
|
|
Projection = selection.Projection,
|
|
|
|
|
Descending = selection.Descending,
|
|
|
|
|
Limit = selection.Limit,
|
|
|
|
|
Cursor = selection.Cursor
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Builds the wire record for one evaluated row. The shared path under snapshot and change
|
|
|
|
|
/// (docs/cultnet-selection-cut.md, section 8's "shared paths").
|
|
|
|
|
/// </summary>
|
|
|
|
|
internal CultNetRawDocumentRecord ToRawRecord(CultNetSelectionEvaluator.Row row, CultNetDocumentMessageOptions? options = null) =>
|
|
|
|
|
ToRawRecord(row.Descriptor, row.Key, row.Document, string.IsNullOrEmpty(row.StoredAt) ? ResolveStoredAt(options) : row.StoredAt, options);
|
|
|
|
|
|
|
|
|
|
internal CultNetRawDocumentRecord ToRawRecord(
|
|
|
|
|
CultDocumentDescriptor descriptor,
|
|
|
|
|
CultRecordKey key,
|
|
|
|
|
object document,
|
|
|
|
|
string storedAt,
|
|
|
|
|
CultNetDocumentMessageOptions? options = null)
|
|
|
|
|
{
|
|
|
|
|
var binding = GetByDocumentType(descriptor.DocumentType) ??
|
|
|
|
|
new CultNetDocumentBinding(
|
|
|
|
|
descriptor.DocumentType,
|
|
|
|
|
descriptor.SchemaId,
|
|
|
|
|
value => CultDocumentMessagePackSerialization.SerializeUntyped(value, value.GetType(), _documents),
|
|
|
|
|
payload => CultDocumentMessagePackSerialization.DeserializeUntyped(descriptor.DocumentType, payload, _documents));
|
|
|
|
|
|
|
|
|
|
return new CultNetRawDocumentRecord
|
|
|
|
|
{
|
|
|
|
|
SchemaId = binding.SchemaId,
|
|
|
|
|
SchemaName = descriptor.SchemaName,
|
|
|
|
|
SchemaVersion = descriptor.SchemaVersion,
|
|
|
|
|
SchemaContentHash = descriptor.ContentHash,
|
|
|
|
|
RecordKey = key.Value,
|
|
|
|
|
StoredAt = storedAt,
|
|
|
|
|
PayloadEncoding = "messagepack",
|
|
|
|
|
Payload = binding.PayloadSerializer(document),
|
|
|
|
|
SourceRuntimeId = options?.SourceRuntimeId,
|
|
|
|
|
SourceAgentId = options?.SourceAgentId,
|
|
|
|
|
SourceRole = options?.SourceRole,
|
|
|
|
|
Tags = options?.Tags
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private CultNetEdge ToEdge(CultNetSelectionEvaluator.EdgeMatch edge, bool wantDocument)
|
|
|
|
|
{
|
|
|
|
|
var wire = new CultNetEdge
|
|
|
|
|
{
|
|
|
|
|
From = new CultNetRecordRef { SchemaId = edge.From.Descriptor.SchemaId, RecordKey = edge.From.Key.Value },
|
|
|
|
|
Role = edge.Role,
|
|
|
|
|
To = new CultNetRecordRef { SchemaId = edge.To.Descriptor.SchemaId, RecordKey = edge.To.Key.Value }
|
2026-05-06 11:50:10 +01:00
|
|
|
};
|
CultNet selection cut1, commit 1: the shape, the evaluator, v1 messages
docs/cultnet-selection-cut.md section 2/4/6/7/8: CultNetSelection (schemas,
keys, fields, cites, cited, projection, descending, limit, cursor) with its
door validation (S1), and CultNetSelectionEvaluator: the single-row Matches
fast path (D6) and the full Select (order, hop, cursor, paging). Neither
reflects over a document; both read only through the cache's public surface
(commit 0).
Three v1 messages beside v0 (cultnet.snapshot_request.v1,
cultnet.database_subscribe.v1, cultnet.snapshot_response_raw.v1), their
schema files under contracts/cultnet, registry entries and dispatch arms.
CultNetSchemaAliasMatching goes internal -> public (D4), the one alias
matcher. CultNetDatabase gains LastWriteSequence(schemaId, key), confirmed
at the one append site (AppendMutationLogEntry) that every committed write
takes a shard-log sequence, including a local PutAsync outside any shard.
Three engines deleted, one evaluator wired in their place:
- CultNetDocumentRegistry: CreateRawSnapshotResponse's reflection loop over
cache.AllEntries and MatchesRequestedSchema gone; cache.AllStoredDocuments
replaces the reflection entirely. v0 lowers into a Selection and walks the
evaluator's own pages so a v0 caller still sees its whole matching set
(D3: v0 has no engine of its own). CreateSelectionResponse/SelectPage/
ToRawRecord/CreateSnapshotRequestV1 added.
- CultNetDatabaseServer: CreateChangeMessage/CreateRawDocumentRecord/Matches/
MatchesSchema/InferSchemaName (122 lines) deleted; CreateSubscription lowers
v0 into a Selection and matches through the evaluator.
- CultNetDatabaseSubscriptionServer: CreateAuthorizedChange/CreateChange/
CreateChangeCore/ResolveWireSchemaId/MatchesRequestedSchema/CreateRawRecord
(92 lines) deleted, replaced by CreateMatchedRecord. _projectRecord and
CreateProjectedSnapshot's collapse are commit 2's, per the map's own
deletion line, and are untouched here.
Discrepancy found and fixed (not in the map): CultNetDocumentBinding can
carry a schema id different from its descriptor's own
(CultNetDocumentBinding.ForDocument's schemaId override), which the old
per-engine matchers checked and a descriptor-only evaluator cannot see by
design (it stays decoupled from CultNetDocumentRegistry). Fixed at the two
call sites and in CultNetDocumentRegistry.SelectPage by resolving the
binding's schema id into the effective selection before evaluation
(CultNetSchemaAliasMatching.WithBindingSchemaAlias,
CultNetDocumentRegistry.ExpandSchemaBindingAliases), not in the evaluator.
Found by DatabaseSubscription_FiltersLiveChangesByWireSchemaBinding timing
out; both call sites now pass.
Second discrepancy, reported not fixed: CultNetDatabase.cs:1707 has a fourth,
undocumented copy of schema-matching logic (MatchesRequestedSchema, private,
serving CreateShardSnapshotResponse), which the map's section 1 audit did not
name among "three separate selector engines". Left untouched this commit:
it is out of the map's explicit deletes list and touching it risks shard
snapshot behavior with no budgeted verification.
Verification: dotnet test tests/GameCult.Networking.Tests - 162 passed (150
existing + 12 new), 0 failed; the seven map-named tests all still pass, two
rewritten for the new signatures (CreateChangeMessage now takes
CultNetSelection; CreateChange/CreateAuthorizedChange collapsed into
CreateMatchedRecord, returning CultNetRawDocumentRecord? directly).
tests/GameCult.Mesh.Tests - 252 passed, 1 pre-existing skip, 0 failed (no
Mesh source touched this commit). tests/GameCult.Caching.Tests - unaffected
(188, unchanged from commit 0).
Negative greps: GetProperty|GetField|GetCustomAttribute in
GameCult.Networking - only against the generic `object change` dispatch
(CultNetDatabaseChange<T>) and CultRecordHandle<T> construction, pre-existing
and out of this cut's scope, never against a document's declared values.
_projectRecord survives in CultNetDatabaseSubscriptionServer.cs (expected,
commit 2). CultNetSchemaAliasMatching is the only schema matcher outside the
one reported discrepancy.
scripts/mutate-dotnet.ps1: the caching mutation runner generalized into a
shared dotnet/NUnit harness (Target/TestProject/Entries/ControlFilter),
replacing scripts/mutate-cultnet-selection-caching.ps1 with an entries file
of the same six mutations (re-verified: all six still KILL). It is now
generic to any NUnit project in this repo, not only this campaign's two
targets - a candidate to sit beside tools/eureka-mutations.ps1 as the
dotnet-side counterpart. Nine new networking entries (S3, S5 x2, S7 x2,
S16 x2, S18) all KILLED. Not yet mutation-run: S1, S2, S6, S23 (pinned by
tests, not by a committed mutant); S9-S15 (subscription reconcile lowering,
v0 no-engine-of-its-own); S17, S20 (pinned by tests only). S19/S21/S22 are
cache-layer, covered in commit 0.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 02:31:42 +02:00
|
|
|
if (wantDocument && edge.Payload != null)
|
|
|
|
|
{
|
|
|
|
|
wire.PayloadEncoding = "messagepack";
|
|
|
|
|
wire.Payload = CultDocumentMessagePackSerialization.SerializeUntyped(edge.Payload, edge.Payload.GetType(), _documents);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return wire;
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Applies a raw document put message to a cache.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public async Task<object> ApplyRawDocumentPutMessageAsync(
|
2026-05-06 11:50:10 +01:00
|
|
|
CultCache cache,
|
|
|
|
|
CultNetDocumentPutRawMessage message)
|
|
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
if (message.Document == null)
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
throw new ArgumentException("CultNet raw document message is missing its document payload.", nameof(message));
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-07-19 08:07:48 +01:00
|
|
|
var document = DeserializeRawDocument(message.Document);
|
|
|
|
|
var descriptor = ResolveDescriptorForRawDocument(message.Document);
|
2026-05-08 01:13:15 +01:00
|
|
|
|
|
|
|
|
var addMethod = typeof(CultCache).GetMethod(nameof(CultCache.AddAsync))!
|
|
|
|
|
.MakeGenericMethod(descriptor.DocumentType);
|
|
|
|
|
var handleType = typeof(CultRecordHandle<>).MakeGenericType(descriptor.DocumentType);
|
|
|
|
|
var optionalHandle = Activator.CreateInstance(typeof(Nullable<>).MakeGenericType(handleType), new object[] { Activator.CreateInstance(handleType, new object[] { new CultRecordKey(message.Document.RecordKey) })! });
|
|
|
|
|
var task = (Task)addMethod.Invoke(cache, [document, optionalHandle])!;
|
|
|
|
|
await task.ConfigureAwait(false);
|
|
|
|
|
return document;
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-07-19 08:07:48 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Decodes one validated raw document without materializing it in a CultCache replica.
|
|
|
|
|
/// Use this for ephemeral reactive subscriptions whose callback is the consumer.
|
|
|
|
|
/// </summary>
|
|
|
|
|
public object DeserializeRawDocument(CultNetRawDocumentRecord document)
|
|
|
|
|
{
|
|
|
|
|
if (document == null) throw new ArgumentNullException(nameof(document));
|
|
|
|
|
ValidateRawDocumentRecord(document);
|
|
|
|
|
var binding = GetBySchemaId(document.SchemaId);
|
|
|
|
|
var descriptor = binding != null
|
|
|
|
|
? _documents.GetRequired(binding.DocumentType)
|
|
|
|
|
: ResolveDescriptorForRawDocument(document);
|
|
|
|
|
binding ??= new CultNetDocumentBinding(
|
|
|
|
|
descriptor.DocumentType,
|
|
|
|
|
descriptor.SchemaId,
|
|
|
|
|
value => CultDocumentMessagePackSerialization.SerializeUntyped(value, value.GetType()),
|
|
|
|
|
payload => CultDocumentMessagePackSerialization.DeserializeUntyped(descriptor.DocumentType, payload));
|
|
|
|
|
return binding.PayloadDeserializer(document.Payload);
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Applies a raw document put message and returns the typed document.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public async Task<T> ApplyRawDocumentPutMessageAsync<T>(
|
|
|
|
|
CultCache cache,
|
|
|
|
|
CultNetDocumentPutRawMessage message)
|
2026-05-08 01:13:15 +01:00
|
|
|
where T : class
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
return (T)await ApplyRawDocumentPutMessageAsync(cache, message).ConfigureAwait(false);
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Applies all documents from a raw snapshot response.
|
|
|
|
|
/// </summary>
|
2026-05-08 01:13:15 +01:00
|
|
|
public async Task<IReadOnlyList<object>> ApplyRawSnapshotResponseAsync(
|
2026-05-06 11:50:10 +01:00
|
|
|
CultCache cache,
|
|
|
|
|
CultNetSnapshotResponseRawMessage response)
|
|
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
var applied = new List<object>(response.Documents.Length);
|
2026-05-06 11:50:10 +01:00
|
|
|
foreach (var document in response.Documents)
|
|
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
applied.Add(await ApplyRawDocumentPutMessageAsync(
|
2026-05-06 11:50:10 +01:00
|
|
|
cache,
|
|
|
|
|
new CultNetDocumentPutRawMessage
|
|
|
|
|
{
|
|
|
|
|
MessageId = response.MessageId,
|
|
|
|
|
Document = document
|
2026-05-08 01:13:15 +01:00
|
|
|
}).ConfigureAwait(false));
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return applied;
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-27 21:22:25 +01:00
|
|
|
internal CultDocumentDescriptor ResolveDescriptorForRawDocument(CultNetRawDocumentRecord document)
|
2026-06-27 21:12:05 +01:00
|
|
|
{
|
|
|
|
|
try
|
|
|
|
|
{
|
2026-06-27 22:07:31 +01:00
|
|
|
return ResolveDescriptorForSchemaId(document.SchemaId);
|
2026-06-27 21:12:05 +01:00
|
|
|
}
|
|
|
|
|
catch (InvalidOperationException) when (TryResolveDescriptorByPayloadSchema(document.Payload) is { } descriptor)
|
|
|
|
|
{
|
|
|
|
|
return descriptor;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-27 22:07:31 +01:00
|
|
|
internal CultDocumentDescriptor ResolveDescriptorForSchemaId(string schemaId)
|
|
|
|
|
{
|
|
|
|
|
try
|
|
|
|
|
{
|
|
|
|
|
return _documents.GetRequiredBySchemaId(schemaId);
|
|
|
|
|
}
|
|
|
|
|
catch (InvalidOperationException) when (TryResolveDescriptorBySchemaAlias(schemaId) is { } descriptor)
|
|
|
|
|
{
|
|
|
|
|
return descriptor;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private CultDocumentDescriptor? TryResolveDescriptorBySchemaAlias(string schemaId)
|
|
|
|
|
{
|
|
|
|
|
if (string.IsNullOrWhiteSpace(schemaId))
|
|
|
|
|
return null;
|
|
|
|
|
|
|
|
|
|
var candidates = ResolvePayloadSchemaCandidates().ToArray();
|
|
|
|
|
var descriptor = candidates.FirstOrDefault(candidate =>
|
|
|
|
|
string.Equals(candidate.SchemaId, schemaId, StringComparison.Ordinal) ||
|
|
|
|
|
string.Equals(candidate.SchemaName, schemaId, StringComparison.Ordinal) ||
|
|
|
|
|
string.Equals(candidate.SchemaVersion, schemaId, StringComparison.Ordinal) ||
|
|
|
|
|
candidate.ToCatalogEntry().CompatibleSchemaIds.Any(compatible =>
|
|
|
|
|
string.Equals(compatible, schemaId, StringComparison.Ordinal)));
|
|
|
|
|
if (descriptor != null)
|
|
|
|
|
return descriptor;
|
|
|
|
|
|
|
|
|
|
var schemaName = InferSchemaName(schemaId);
|
|
|
|
|
return string.IsNullOrWhiteSpace(schemaName)
|
|
|
|
|
? null
|
|
|
|
|
: candidates.FirstOrDefault(candidate =>
|
|
|
|
|
string.Equals(candidate.SchemaName, schemaName, StringComparison.Ordinal));
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-27 21:12:05 +01:00
|
|
|
private CultDocumentDescriptor? TryResolveDescriptorByPayloadSchema(byte[] payload)
|
|
|
|
|
{
|
|
|
|
|
var schemaVersion = TryReadSchemaVersion(payload);
|
|
|
|
|
if (string.IsNullOrWhiteSpace(schemaVersion))
|
|
|
|
|
return null;
|
|
|
|
|
|
|
|
|
|
var candidates = ResolvePayloadSchemaCandidates().ToArray();
|
|
|
|
|
var descriptor = candidates.FirstOrDefault(candidate =>
|
|
|
|
|
string.Equals(candidate.SchemaVersion, schemaVersion, StringComparison.Ordinal));
|
|
|
|
|
if (descriptor != null)
|
|
|
|
|
return descriptor;
|
|
|
|
|
|
|
|
|
|
var schemaName = InferSchemaName(schemaVersion!);
|
|
|
|
|
return string.IsNullOrWhiteSpace(schemaName)
|
|
|
|
|
? null
|
|
|
|
|
: candidates.FirstOrDefault(candidate =>
|
|
|
|
|
string.Equals(candidate.SchemaName, schemaName, StringComparison.Ordinal));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private IEnumerable<CultDocumentDescriptor> ResolvePayloadSchemaCandidates()
|
|
|
|
|
{
|
|
|
|
|
if (_bindingsBySchemaId.Count == 0 && _bindingsByType.Count == 0)
|
|
|
|
|
return _documents.AllDescriptors;
|
|
|
|
|
|
|
|
|
|
return _bindingsBySchemaId.Values
|
|
|
|
|
.Concat(_bindingsByType.Values)
|
|
|
|
|
.Select(binding => _documents.GetRequired(binding.DocumentType))
|
|
|
|
|
.GroupBy(descriptor => descriptor.DocumentType)
|
|
|
|
|
.Select(group => group.First());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static string? TryReadSchemaVersion(byte[] payload)
|
|
|
|
|
{
|
|
|
|
|
try
|
|
|
|
|
{
|
|
|
|
|
var array = MessagePackSerializer.Deserialize<object[]>(
|
|
|
|
|
payload,
|
|
|
|
|
CultNetSchemaMessageSerialization.Options);
|
|
|
|
|
if (array.Length > 0 && array[0] is string schemaVersion)
|
|
|
|
|
return schemaVersion;
|
|
|
|
|
}
|
|
|
|
|
catch (Exception)
|
|
|
|
|
{
|
|
|
|
|
// Fall through to map decoding; different runtimes may encode object-like payloads.
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
try
|
|
|
|
|
{
|
|
|
|
|
var map = MessagePackSerializer.Deserialize<IReadOnlyDictionary<string, object?>>(
|
|
|
|
|
payload,
|
|
|
|
|
CultNetSchemaMessageSerialization.Options);
|
|
|
|
|
if (map.TryGetValue("schemaVersion", out var schemaVersion) &&
|
|
|
|
|
schemaVersion is string schemaVersionText)
|
|
|
|
|
return schemaVersionText;
|
|
|
|
|
if (map.TryGetValue("schema_version", out var snakeSchemaVersion) &&
|
|
|
|
|
snakeSchemaVersion is string snakeSchemaVersionText)
|
|
|
|
|
return snakeSchemaVersionText;
|
|
|
|
|
}
|
|
|
|
|
catch (Exception)
|
|
|
|
|
{
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static string? InferSchemaName(string schemaVersion)
|
|
|
|
|
{
|
|
|
|
|
var marker = schemaVersion.LastIndexOf(".v", StringComparison.Ordinal);
|
|
|
|
|
if (marker <= 0 || marker + 2 >= schemaVersion.Length)
|
|
|
|
|
return null;
|
|
|
|
|
|
|
|
|
|
var version = schemaVersion.Substring(marker + 2);
|
|
|
|
|
return version.All(char.IsDigit)
|
|
|
|
|
? schemaVersion.Substring(0, marker)
|
|
|
|
|
: null;
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 13:11:01 +01:00
|
|
|
/// <summary>
|
|
|
|
|
/// Applies all typed documents from a raw snapshot response.
|
|
|
|
|
/// </summary>
|
2026-05-06 11:50:10 +01:00
|
|
|
public async Task<IReadOnlyList<T>> ApplyRawSnapshotResponseAsync<T>(
|
|
|
|
|
CultCache cache,
|
|
|
|
|
CultNetSnapshotResponseRawMessage response)
|
2026-05-08 01:13:15 +01:00
|
|
|
where T : class
|
2026-05-06 11:50:10 +01:00
|
|
|
{
|
2026-05-08 01:13:15 +01:00
|
|
|
return (await ApplyRawSnapshotResponseAsync(cache, response).ConfigureAwait(false)).OfType<T>().ToArray();
|
2026-05-06 11:50:10 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static void ValidateRawDocumentRecord(CultNetRawDocumentRecord document)
|
|
|
|
|
{
|
|
|
|
|
if (document.PayloadEncoding != "messagepack")
|
|
|
|
|
{
|
|
|
|
|
throw new InvalidOperationException(
|
|
|
|
|
$"CultNet raw document payloadEncoding must be \"messagepack\", not \"{document.PayloadEncoding}\".");
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-08 01:13:15 +01:00
|
|
|
RequireNonEmpty(document.SchemaId, nameof(document.SchemaId));
|
|
|
|
|
RequireNonEmpty(document.RecordKey, nameof(document.RecordKey));
|
|
|
|
|
RequireNonEmpty(document.StoredAt, nameof(document.StoredAt));
|
2026-05-06 11:50:10 +01:00
|
|
|
if (document.Payload == null || document.Payload.Length == 0)
|
|
|
|
|
{
|
|
|
|
|
throw new InvalidOperationException("CultNet raw document payload must be non-empty.");
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static string ResolveStoredAt(CultNetDocumentMessageOptions? options)
|
|
|
|
|
{
|
|
|
|
|
return !string.IsNullOrWhiteSpace(options?.StoredAt)
|
|
|
|
|
? options!.StoredAt!
|
|
|
|
|
: DateTimeOffset.UtcNow.ToString("O", CultureInfo.InvariantCulture);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static string RequireNonEmpty(string value, string paramName)
|
|
|
|
|
{
|
|
|
|
|
if (string.IsNullOrWhiteSpace(value))
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentException("Value must be non-empty.", paramName);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return value;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|