using System.Security.Cryptography; using System.Text; using ZB.MOM.WW.ScadaBridge.Commons.Types.Transport; using ZB.MOM.WW.ScadaBridge.Transport.Serialization; namespace ZB.MOM.WW.ScadaBridge.Transport.Tests.Serialization; public sealed class ManifestBuilderTests { private static BundleSummary EmptySummary => new(0, 0, 0, 0, 0, 0, 0, 0); private static IReadOnlyList NoContents => Array.Empty(); /// Verifies that building a manifest populates the summary from the contents. [Fact] public void Build_populates_summary_from_contents() { var sut = new ManifestBuilder(); // Summary now carries trailing Sites/DataConnections/Instances counts. var summary = new BundleSummary(2, 1, 0, 0, 0, 0, 0, 0, Sites: 3, DataConnections: 4, Instances: 5); var contents = new[] { new ManifestContentEntry("Template", "T1", 1, Array.Empty()), new ManifestContentEntry("Template", "T2", 1, new[] { "T1" }), new ManifestContentEntry("TemplateFolder", "F1", 1, Array.Empty()), }; var manifest = sut.Build("env", "user", "1.0.0", encryption: null, summary, contents, contentBytes: new byte[] { 1, 2, 3 }); Assert.Equal(summary, manifest.Summary); // New summary counts flow through the builder verbatim. Assert.Equal(3, manifest.Summary.Sites); Assert.Equal(4, manifest.Summary.DataConnections); Assert.Equal(5, manifest.Summary.Instances); Assert.Equal(contents, manifest.Contents); Assert.Equal("env", manifest.SourceEnvironment); Assert.Equal("user", manifest.ExportedBy); Assert.Equal("1.0.0", manifest.ScadaBridgeVersion); Assert.Equal(1, manifest.BundleFormatVersion); // Schema minor bumped 1.0 → 1.1; format version stays 1. Assert.Equal("1.1", manifest.SchemaVersion); Assert.Null(manifest.Encryption); } /// Verifies that building a manifest computes a content hash with the sha256 prefix. [Fact] public void Build_computes_content_hash_with_sha256_prefix() { var sut = new ManifestBuilder(); var bytes = Encoding.UTF8.GetBytes("known-content"); var expectedHashHex = Convert.ToHexString(SHA256.HashData(bytes)).ToLowerInvariant(); var manifest = sut.Build("env", "user", "v", encryption: null, EmptySummary, NoContents, bytes); Assert.Equal("sha256:" + expectedHashHex, manifest.ContentHash); } /// Verifies that validation rejects an unsupported bundle format version. [Fact] public void Validate_rejects_unsupported_bundleFormatVersion() { var bytes = new byte[] { 1, 2, 3 }; var hash = "sha256:" + Convert.ToHexString(SHA256.HashData(bytes)).ToLowerInvariant(); var manifest = new BundleManifest( BundleFormatVersion: 999, SchemaVersion: "1.0", CreatedAtUtc: DateTimeOffset.UtcNow, SourceEnvironment: "env", ExportedBy: "u", ScadaBridgeVersion: "v", ContentHash: hash, Encryption: null, Summary: EmptySummary, Contents: NoContents); var result = new ManifestValidator().Validate(manifest, bytes); Assert.Equal(ManifestValidationResult.UnsupportedFormatVersion, result); } /// Verifies that validation rejects a manifest whose content hash does not match. [Fact] public void Validate_rejects_when_contentHash_mismatch() { var bytes = new byte[] { 1, 2, 3 }; var manifest = new BundleManifest( BundleFormatVersion: 1, SchemaVersion: "1.0", CreatedAtUtc: DateTimeOffset.UtcNow, SourceEnvironment: "env", ExportedBy: "u", ScadaBridgeVersion: "v", ContentHash: "sha256:deadbeef", Encryption: null, Summary: EmptySummary, Contents: NoContents); var result = new ManifestValidator().Validate(manifest, bytes); Assert.Equal(ManifestValidationResult.ContentHashMismatch, result); } /// Verifies that validation accepts a well-formed version 1 manifest. [Fact] public void Validate_accepts_well_formed_v1_manifest() { var sut = new ManifestBuilder(); var bytes = Encoding.UTF8.GetBytes("hello"); var manifest = sut.Build("env", "u", "v", encryption: null, EmptySummary, NoContents, bytes); var result = new ManifestValidator().Validate(manifest, bytes); Assert.Equal(ManifestValidationResult.Ok, result); } /// Verifies that validation accepts an older schema version 1.0 manifest. [Fact] public void Validate_accepts_older_schemaVersion_1_0_manifest() { // An older "1.0" bundle must still import: schema minor differences // are additive and the validator gates only on BundleFormatVersion. var bytes = Encoding.UTF8.GetBytes("legacy-bundle"); var hash = "sha256:" + Convert.ToHexString(SHA256.HashData(bytes)).ToLowerInvariant(); var manifest = new BundleManifest( BundleFormatVersion: ManifestBuilder.CurrentBundleFormatVersion, SchemaVersion: "1.0", CreatedAtUtc: DateTimeOffset.UtcNow, SourceEnvironment: "env", ExportedBy: "u", ScadaBridgeVersion: "v", ContentHash: hash, Encryption: null, Summary: EmptySummary, Contents: NoContents); var result = new ManifestValidator().Validate(manifest, bytes); Assert.Equal(ManifestValidationResult.Ok, result); } /// Verifies that validation refuses bundle format version 2. [Fact] public void Validate_refuses_bundleFormatVersion_2() { // A future format-version 2 is a hard refusal (not a minor schema bump). var bytes = Encoding.UTF8.GetBytes("future-bundle"); var hash = "sha256:" + Convert.ToHexString(SHA256.HashData(bytes)).ToLowerInvariant(); var manifest = new BundleManifest( BundleFormatVersion: 2, SchemaVersion: "1.1", CreatedAtUtc: DateTimeOffset.UtcNow, SourceEnvironment: "env", ExportedBy: "u", ScadaBridgeVersion: "v", ContentHash: hash, Encryption: null, Summary: EmptySummary, Contents: NoContents); var result = new ManifestValidator().Validate(manifest, bytes); Assert.Equal(ManifestValidationResult.UnsupportedFormatVersion, result); } }