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 { [Key(2)] [CultElementId] public string Id { get; set; } = string.Empty; /// 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 { [Key(6)] [CultElementId] public string Id { get; set; } = string.Empty; /// 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 { [Key(10)] [CultElementId] public string Id { get; set; } = string.Empty; /// 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)] [CultRole] public string Version { get; set; } = string.Empty; /// Tool that authored the package, such as Brokkr Blender. [Key(2)] [CultRole] 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)] [CultRole] public string SourceCollection { get; set; } = string.Empty; /// Stable hash of graph structure and referenced assets. [Key(5)] [CultRole] 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)); } } }