using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using GameCult.Caching;
using GameCult.Networking;
using MessagePack;
namespace GameCult.Mesh
{
///
/// Schema versions for portable entity prefab packages.
///
public static class CultMeshEntityPrefabSchemaVersions
{
/// Portable prefab package schema id.
public const string Package = "gamecult.mesh.entity_prefab_package.v1";
}
///
/// Well-known portable prefab node kinds.
///
public static class CultMeshEntityPrefabNodeKinds
{
/// Transform-only node.
public const string Empty = "empty";
/// Renderable mesh node.
public const string Mesh = "mesh";
/// Collider node.
public const string Collider = "collider";
/// Particle or projectile effect node.
public const string Effect = "effect";
/// Camera or view anchor node.
public const string Camera = "camera";
/// Runtime attachment point.
public const string Socket = "socket";
}
///
/// Well-known prefab asset roles.
///
public static class CultMeshEntityPrefabAssetRoles
{
/// Mesh geometry payload.
public const string Mesh = "mesh";
/// Texture image payload.
public const string Texture = "texture";
/// Material definition payload.
public const string Material = "material";
/// Animation clip payload.
public const string Animation = "animation";
/// Audio payload.
public const string Audio = "audio";
}
///
/// Portable transform using Blender/CultMesh source coordinates before runtime lowering.
///
[MessagePackObject]
public sealed class CultMeshEntityPrefabTransform
{
/// Local position vector.
[Key(0)]
public float[] Position { get; set; } = [0f, 0f, 0f];
/// Local rotation quaternion.
[Key(1)]
public float[] Rotation { get; set; } = [0f, 0f, 0f, 1f];
/// Local scale vector.
[Key(2)]
public float[] Scale { get; set; } = [1f, 1f, 1f];
}
///
/// Runtime component intent attached to a portable prefab node.
///
[MessagePackObject]
public sealed class CultMeshEntityPrefabComponent
{
/// Portable component kind or runtime adapter type.
[Key(0)]
public string Type { get; set; } = string.Empty;
/// String-valued component properties for runtime-specific lowering.
[Key(1)]
public Dictionary Properties { get; set; } = new();
}
///
/// Reference from a prefab package to a CDN artifact manifest.
///
[MessagePackObject]
public sealed class CultMeshEntityPrefabAssetRef
{
/// Stable source asset id inside the prefab package.
[Key(0)]
public string AssetId { get; set; } = string.Empty;
/// Semantic role, such as mesh, texture, material, or animation.
[Key(1)]
public string Role { get; set; } = string.Empty;
/// CultCache record key for the referenced CDN artifact manifest.
[Key(2)]
public string CdnManifestRecordKey { get; set; } = string.Empty;
/// Full artifact content hash copied from the referenced CDN manifest.
[Key(3)]
public string ContentHash { get; set; } = string.Empty;
/// Artifact MIME type copied from the referenced CDN manifest.
[Key(4)]
public string MimeType { get; set; } = string.Empty;
/// Runtime and source metadata for the asset reference.
[Key(5)]
public Dictionary Metadata { get; set; } = new();
}
///
/// One node in a portable entity prefab graph.
///
[MessagePackObject]
public sealed class CultMeshEntityPrefabNode
{
/// Stable node id inside the package.
[Key(0)]
public string NodeId { get; set; } = string.Empty;
/// Source object name.
[Key(1)]
public string Name { get; set; } = string.Empty;
/// Optional parent node id.
[Key(2)]
public string ParentNodeId { get; set; } = string.Empty;
/// Node kind.
[Key(3)]
public string Kind { get; set; } = CultMeshEntityPrefabNodeKinds.Empty;
/// Local transform.
[Key(4)]
public CultMeshEntityPrefabTransform Transform { get; set; } = new();
/// Optional mesh asset id used by this node.
[Key(5)]
public string MeshAssetId { get; set; } = string.Empty;
/// Material asset ids used by this node.
[Key(6)]
public string[] MaterialAssetIds { get; set; } = Array.Empty();
/// Runtime component intents attached to this node.
[Key(7)]
public CultMeshEntityPrefabComponent[] Components { get; set; } = Array.Empty();
/// Runtime tags copied from source metadata.
[Key(8)]
public string[] Tags { get; set; } = Array.Empty();
/// Additional source metadata.
[Key(9)]
public Dictionary Metadata { get; set; } = new();
}
///
/// Portable entity prefab package authored from a Blender collection and lowerable into multiple runtimes.
///
[MessagePackObject]
[CultDocument("gamecult.mesh.entity_prefab_package", CultMeshEntityPrefabSchemaVersions.Package)]
public sealed class CultMeshEntityPrefabPackage
{
/// Stable logical prefab id.
[Key(0)]
[CultName]
public string PrefabId { get; set; } = string.Empty;
/// Caller-defined package version.
[Key(1)]
[CultIndex]
public string Version { get; set; } = string.Empty;
/// Tool that authored the package, such as Brokkr Blender.
[Key(2)]
[CultIndex]
public string SourceTool { get; set; } = string.Empty;
/// Source scene name or path.
[Key(3)]
public string SourceScene { get; set; } = string.Empty;
/// Source Blender collection name.
[Key(4)]
[CultIndex]
public string SourceCollection { get; set; } = string.Empty;
/// Stable hash of graph structure and referenced assets.
[Key(5)]
[CultIndex]
public string ContentHash { get; set; } = string.Empty;
/// Package creation timestamp in round-trip UTC format.
[Key(6)]
public string CreatedAtUtc { get; set; } = string.Empty;
/// Referenced CDN assets.
[Key(7)]
public CultMeshEntityPrefabAssetRef[] Assets { get; set; } = Array.Empty();
/// Prefab hierarchy nodes.
[Key(8)]
public CultMeshEntityPrefabNode[] Nodes { get; set; } = Array.Empty();
/// Search and routing tags.
[Key(9)]
public string[] Tags { get; set; } = Array.Empty();
/// Package-level metadata.
[Key(10)]
public Dictionary Metadata { get; set; } = new();
/// Builds the deterministic package record key.
public static CultRecordKey CreateRecordKey(CultMeshEntityPrefabPackage package)
{
if (package == null) throw new ArgumentNullException(nameof(package));
return CreateRecordKey(package.PrefabId, package.Version, package.ContentHash);
}
/// Builds the deterministic package record key.
public static CultRecordKey CreateRecordKey(string prefabId, string version, string contentHash)
{
var prefabToken = CultMeshCdn.StableToken(prefabId, nameof(prefabId));
var versionToken = string.IsNullOrWhiteSpace(version)
? "unversioned"
: CultMeshCdn.StableToken(version, nameof(version));
return new CultRecordKey(
"mesh:entity-prefab:" + prefabToken + ":" + versionToken + ":" + CultMeshCdn.NormalizeHash(contentHash, nameof(contentHash)));
}
}
///
/// Helpers for publishing and validating portable entity prefab packages.
///
public static class CultMeshEntityPrefabs
{
///
/// Computes a stable package content hash from graph structure and referenced asset hashes.
///
public static string ComputeContentHash(CultMeshEntityPrefabPackage package)
{
if (package == null) throw new ArgumentNullException(nameof(package));
var builder = new StringBuilder();
builder.Append(package.PrefabId).Append('\u001F')
.Append(package.Version).Append('\u001F')
.Append(package.SourceTool).Append('\u001F')
.Append(package.SourceScene).Append('\u001F')
.Append(package.SourceCollection).Append('\u001F');
foreach (var asset in package.Assets.OrderBy(asset => asset.AssetId, StringComparer.Ordinal))
{
builder.Append("asset").Append('\u001E')
.Append(asset.AssetId).Append('\u001E')
.Append(asset.Role).Append('\u001E')
.Append(asset.CdnManifestRecordKey).Append('\u001E')
.Append(CultMeshCdn.NormalizeHash(asset.ContentHash, nameof(asset.ContentHash))).Append('\u001E')
.Append(asset.MimeType).Append('\u001E')
.Append(StableMap(asset.Metadata)).Append('\u001F');
}
foreach (var node in package.Nodes.OrderBy(node => node.NodeId, StringComparer.Ordinal))
{
builder.Append("node").Append('\u001E')
.Append(node.NodeId).Append('\u001E')
.Append(node.Name).Append('\u001E')
.Append(node.ParentNodeId).Append('\u001E')
.Append(node.Kind).Append('\u001E')
.Append(StableFloats(node.Transform.Position)).Append('\u001E')
.Append(StableFloats(node.Transform.Rotation)).Append('\u001E')
.Append(StableFloats(node.Transform.Scale)).Append('\u001E')
.Append(node.MeshAssetId).Append('\u001E')
.Append(string.Join(",", node.MaterialAssetIds.OrderBy(value => value, StringComparer.Ordinal))).Append('\u001E')
.Append(StableComponents(node.Components)).Append('\u001E')
.Append(string.Join(",", node.Tags.OrderBy(value => value, StringComparer.Ordinal))).Append('\u001E')
.Append(StableMap(node.Metadata)).Append('\u001F');
}
builder.Append(string.Join(",", package.Tags.OrderBy(value => value, StringComparer.Ordinal))).Append('\u001F')
.Append(StableMap(package.Metadata));
return CultMeshCdn.HashBytes(Encoding.UTF8.GetBytes(builder.ToString()));
}
///
/// Stamps the current content hash and creation timestamp on a package.
///
public static CultMeshEntityPrefabPackage FinalizePackage(CultMeshEntityPrefabPackage package)
{
if (package == null) throw new ArgumentNullException(nameof(package));
package.CreatedAtUtc = string.IsNullOrWhiteSpace(package.CreatedAtUtc)
? DateTimeOffset.UtcNow.ToString("O", CultureInfo.InvariantCulture)
: package.CreatedAtUtc;
package.ContentHash = ComputeContentHash(package);
return package;
}
///
/// Publishes a finalized portable entity prefab package into a local cache.
///
public static async Task PublishAsync(
CultCache cache,
CultMeshEntityPrefabPackage package)
{
if (cache == null) throw new ArgumentNullException(nameof(cache));
if (package == null) throw new ArgumentNullException(nameof(package));
ValidatePackage(package);
await cache.UpsertAsync(
package,
new CultRecordHandle(
CultMeshEntityPrefabPackage.CreateRecordKey(package))).ConfigureAwait(false);
return package;
}
///
/// Publishes a finalized portable entity prefab package into a distributed CultNet database.
///
public static async Task PublishAsync(
CultNetDatabase database,
CultMeshEntityPrefabPackage package)
{
if (database == null) throw new ArgumentNullException(nameof(database));
if (package == null) throw new ArgumentNullException(nameof(package));
ValidatePackage(package);
await database.PutAsync(CultMeshEntityPrefabPackage.CreateRecordKey(package), package)
.ConfigureAwait(false);
return package;
}
///
/// Creates a raw CultNet document registry for entity prefab packages.
///
public static CultNetDocumentRegistry CreateDocumentRegistry(CultDocumentRegistry? documents = null)
{
documents ??= CultDocumentRegistry.Shared;
return new CultNetDocumentRegistry(documents)
.Register(CultNetDocumentBinding.ForDocument(documents));
}
///
/// Creates a raw CultNet document registry for CDN assets and portable entity prefab packages.
///
public static CultNetDocumentRegistry CreateAssetPipelineDocumentRegistry(CultDocumentRegistry? documents = null)
{
documents ??= CultDocumentRegistry.Shared;
return CultMeshCdn.CreateDocumentRegistry(documents)
.Register(CultNetDocumentBinding.ForDocument(documents));
}
private static void ValidatePackage(CultMeshEntityPrefabPackage package)
{
if (string.IsNullOrWhiteSpace(package.PrefabId))
{
throw new ArgumentException("Prefab id must be non-empty.", nameof(package));
}
var expectedHash = ComputeContentHash(package);
if (!string.Equals(CultMeshCdn.NormalizeHash(package.ContentHash, nameof(package.ContentHash)), expectedHash, StringComparison.Ordinal))
{
throw new InvalidOperationException("Entity prefab package content hash does not match its graph.");
}
}
private static string StableComponents(IEnumerable components)
{
return string.Join("|", components
.OrderBy(component => component.Type, StringComparer.Ordinal)
.Select(component => component.Type + "=" + StableMap(component.Properties)));
}
private static string StableFloats(IEnumerable values)
{
return string.Join(",", values.Select(value => value.ToString("R", CultureInfo.InvariantCulture)));
}
private static string StableMap(Dictionary values)
{
return string.Join("|", values
.OrderBy(pair => pair.Key, StringComparer.Ordinal)
.Select(pair => pair.Key + "=" + pair.Value));
}
}
}