using FluentAssertions; using SatelliteProvider.Common.Utils; namespace SatelliteProvider.Tests; // AZ-503 AC-1: Uuidv5.Create must produce byte-identical output to Python's // stdlib `uuid.uuid5(namespace, name)`. Expected values below were generated // against TILE_NAMESPACE = 5b8d0c2e-7f1a-4d3b-9c5e-1f3a8e7d2b6c using Python // 3.x's `uuid` module and pasted as fixed-string assertions (per AZ-503 spec // Risk 2 mitigation — vectors are explicit, not computed at test time). // // The cross-repo contract: gps-denied-onboard `c6_tile_cache/_uuid.py` MUST // use the SAME namespace constant and Python's stdlib `uuid.uuid5`. Both sides // therefore compute identical IDs for identical (namespace, name) inputs. public class Uuidv5Tests { [Theory] [InlineData("18/12345/23456/google_maps/00000000-0000-0000-0000-000000000000", "89e9514c-066d-5015-973f-ac42758ebf37")] [InlineData("18/12345/23456", "38b26f49-a966-5121-aaf4-9cc476f57869")] [InlineData("15/0/0/google_maps/00000000-0000-0000-0000-000000000000", "82a17784-50f3-58e2-b3a1-5da8224ff19d")] [InlineData("20/1048575/1048575/uav/11111111-2222-3333-4444-555555555555", "9aaefb75-68c1-5691-89b4-3552323ef5de")] [InlineData("16/76800/50331/google_maps/00000000-0000-0000-0000-000000000000", "88576e42-70ae-5977-a809-014d1448b012")] [InlineData("18/12345/23456/uav/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "7d3c86e8-ce9b-5e40-9a08-8ffe6bab346a")] [InlineData("0/0/0/google_maps/00000000-0000-0000-0000-000000000000", "d6557888-270b-59a9-9f21-652fdd0a9e50")] [InlineData("simple-ascii-name", "d33497cd-8017-5ed0-9f9a-b6ff3c852b2a")] [InlineData("unicode-naïveté-✓", "06710360-b8f0-5fe0-8f0a-5e934216e536")] [InlineData("18/76800/50331", "5993e42c-a647-5802-b3a4-50105365832c")] [InlineData("17/57842/41320/uav/12345678-1234-1234-1234-123456789012", "c5a0cac0-7155-5e49-91b8-f29bb0342a96")] public void Create_MatchesPythonUuid5_ForReferenceVectors(string name, string expectedUuid) { // Act var result = Uuidv5.Create(Uuidv5.TileNamespace, name); // Assert result.Should().Be(Guid.Parse(expectedUuid), $"C# Uuidv5.Create must match Python uuid.uuid5({Uuidv5.TileNamespace}, \"{name}\") = {expectedUuid}"); } [Fact] public void Create_IsDeterministic() { // Arrange const string name = "18/12345/23456/google_maps/00000000-0000-0000-0000-000000000000"; // Act var first = Uuidv5.Create(Uuidv5.TileNamespace, name); var second = Uuidv5.Create(Uuidv5.TileNamespace, name); // Assert first.Should().Be(second, "deterministic algorithm must produce identical output for identical inputs"); } [Fact] public void Create_ProducesVersion5AndRfc4122Variant() { // Arrange var name = "any-name"; // Act var uuid = Uuidv5.Create(Uuidv5.TileNamespace, name); var bytes = uuid.ToByteArray(); // Guid.ToByteArray returns mixed-endian; for version/variant bits we // need big-endian byte 6 (version) and byte 8 (variant). Reconstruct // the big-endian view: bytes 0..3 reversed, 4..5 reversed, 6..7 // reversed, 8..15 as-is. var bigEndian = new byte[16]; bigEndian[0] = bytes[3]; bigEndian[1] = bytes[2]; bigEndian[2] = bytes[1]; bigEndian[3] = bytes[0]; bigEndian[4] = bytes[5]; bigEndian[5] = bytes[4]; bigEndian[6] = bytes[7]; bigEndian[7] = bytes[6]; Array.Copy(bytes, 8, bigEndian, 8, 8); // Assert ((bigEndian[6] & 0xF0) >> 4).Should().Be(5, "version nibble (upper 4 bits of byte 6) must be 5 per RFC 9562 §5.5"); (bigEndian[8] & 0xC0).Should().Be(0x80, "variant bits (upper 2 of byte 8) must be 10 per RFC 4122 variant"); } [Fact] public void Create_DifferentNamesProduceDifferentUuids() { // Arrange var name1 = "18/12345/23456/google_maps/00000000-0000-0000-0000-000000000000"; var name2 = "18/12345/23456/google_maps/11111111-1111-1111-1111-111111111111"; // Act var uuid1 = Uuidv5.Create(Uuidv5.TileNamespace, name1); var uuid2 = Uuidv5.Create(Uuidv5.TileNamespace, name2); // Assert uuid1.Should().NotBe(uuid2, "different flight_id values must produce different tile ids"); } [Fact] public void Create_ThrowsOnNullName() { // Act var act = () => Uuidv5.Create(Uuidv5.TileNamespace, null!); // Assert act.Should().Throw(); } }