#Requires -Modules @{ ModuleName = 'Pester'; ModuleVersion = '5.0.0' } BeforeAll { $repoRoot = Split-Path (Split-Path $PSScriptRoot -Parent) -Parent . (Join-Path $repoRoot 'src/Normalization/New-PersonaMembershipRecord.ps1') . (Join-Path $repoRoot 'src/Normalization/New-PersonaUserRecord.ps1') . (Join-Path $repoRoot 'src/RuleEngine/Test-PersonaCondition.ps1') function New-TestUser { param([hashtable] $Properties = @{}, [object] $Membership) New-PersonaUserRecord ` -AccountObjectId '00000000-0000-0000-0000-000000000101' ` -UserPrincipalName 'alex.employee@example.invalid' ` -UserType 'Member' ` -Properties $Properties ` -Membership $Membership } function Test-Op { param([hashtable] $Condition, [object] $User, [string] $Mode = 'Direct') Test-PersonaCondition -Condition ([pscustomobject]$Condition) -UserRecord $User -DefaultMembershipMode $Mode } } Describe 'Property operators (RE-005)' { BeforeAll { $script:user = New-TestUser -Properties @{ Department = 'Finance' JobTitle = 'Senior Analyst' CompanyName = $null EmptyString = '' } } Context 'equals / notEquals' { It 'equals matches' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'equals'; value = 'Finance' } $user | Should -Be 'True' } It 'equals rejects a different value' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'equals'; value = 'Legal' } $user | Should -Be 'False' } It 'notEquals is the inverse' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'notEquals'; value = 'Legal' } $user | Should -Be 'True' } } Context 'case insensitivity (RE-006)' { It 'equals ignores case' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'equals'; value = 'FINANCE' } $user | Should -Be 'True' } It 'contains ignores case' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'contains'; value = 'ANALYST' } $user | Should -Be 'True' } It 'startsWith ignores case' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'startsWith'; value = 'senior' } $user | Should -Be 'True' } It 'endsWith ignores case' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'endsWith'; value = 'ANALYST' } $user | Should -Be 'True' } It 'resolves the property name case-insensitively' { Test-Op @{ type = 'property'; property = 'DEPARTMENT'; operator = 'equals'; value = 'Finance' } $user | Should -Be 'True' } } Context 'contains / notContains' { It 'contains matches a substring' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'contains'; value = 'Analy' } $user | Should -Be 'True' } It 'notContains is the inverse' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'notContains'; value = 'Manager' } $user | Should -Be 'True' } } Context 'startsWith / endsWith' { It 'startsWith matches' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'startsWith'; value = 'Senior' } $user | Should -Be 'True' } It 'startsWith rejects' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'startsWith'; value = 'Junior' } $user | Should -Be 'False' } It 'endsWith matches' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'endsWith'; value = 'Analyst' } $user | Should -Be 'True' } } Context 'matchesRegex' { It 'matches a valid pattern' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'matchesRegex'; value = '^Senior\s+\w+$' } $user | Should -Be 'True' } It 'rejects a non-matching pattern' { Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'matchesRegex'; value = '^Junior' } $user | Should -Be 'False' } It 'returns Unknown for an invalid pattern rather than a false non-match' { # An unparseable regex is a configuration defect. Reporting False would # hide it behind a plausible result. Test-Op @{ type = 'property'; property = 'JobTitle'; operator = 'matchesRegex'; value = '[unclosed' } $user | Should -Be 'Unknown' } } Context 'in / notIn' { It 'in matches a listed value' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'in'; values = @('Legal', 'Finance') } $user | Should -Be 'True' } It 'in rejects an unlisted value' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'in'; values = @('Legal', 'HR') } $user | Should -Be 'False' } It 'notIn is the inverse' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'notIn'; values = @('Legal', 'HR') } $user | Should -Be 'True' } It 'in ignores case' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'in'; values = @('FINANCE') } $user | Should -Be 'True' } } Context 'isNull / isNotNull' { It 'isNull is true for an explicit null' { Test-Op @{ type = 'property'; property = 'CompanyName'; operator = 'isNull' } $user | Should -Be 'True' } It 'isNull is true for an absent property' { Test-Op @{ type = 'property'; property = 'NoSuchProperty'; operator = 'isNull' } $user | Should -Be 'True' } It 'isNull is true for an empty string' { Test-Op @{ type = 'property'; property = 'EmptyString'; operator = 'isNull' } $user | Should -Be 'True' } It 'isNull is false for a populated value' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'isNull' } $user | Should -Be 'False' } It 'isNotNull is the inverse' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'isNotNull' } $user | Should -Be 'True' } } Context 'null handling for ordinary comparisons (FR-012)' { It 'treats a null property as empty rather than failing' { Test-Op @{ type = 'property'; property = 'CompanyName'; operator = 'equals'; value = '' } $user | Should -Be 'True' } It 'treats an absent property as empty rather than failing' { Test-Op @{ type = 'property'; property = 'NoSuchProperty'; operator = 'equals'; value = 'anything' } $user | Should -Be 'False' } It 'never returns Unknown for a null property under an ordinary operator' { # FR-012: null must not cause evaluation failure. Unknown here would # turn every sparse account into an EvaluationError. foreach ($op in @('equals', 'notEquals', 'contains', 'notContains', 'startsWith', 'endsWith')) { Test-Op @{ type = 'property'; property = 'CompanyName'; operator = $op; value = 'x' } $user | Should -Not -Be 'Unknown' -Because "operator '$op' must tolerate a null property" } } } Context 'unsupported operator' { It 'returns Unknown rather than guessing' { Test-Op @{ type = 'property'; property = 'Department'; operator = 'approximatelyEquals'; value = 'Finance' } $user | Should -Be 'Unknown' } } } Describe 'Membership operators' { BeforeAll { $script:tier0 = '00000000-0000-0000-0000-0000000000a0' $script:other = '00000000-0000-0000-0000-0000000000b0' } Context 'successful retrieval' { BeforeAll { $script:member = New-TestUser -Membership (New-PersonaMembershipRecord -DirectGroupObjectIds @($tier0) -DirectRetrieved) } It 'memberOf matches a held group' { Test-Op @{ type = 'membership'; operator = 'memberOf'; groupObjectIds = @($tier0) } $member | Should -Be 'True' } It 'memberOf rejects a group not held' { Test-Op @{ type = 'membership'; operator = 'memberOf'; groupObjectIds = @($other) } $member | Should -Be 'False' } It 'notMemberOf is the inverse' { Test-Op @{ type = 'membership'; operator = 'notMemberOf'; groupObjectIds = @($other) } $member | Should -Be 'True' } It 'matches when any listed group is held' { Test-Op @{ type = 'membership'; operator = 'memberOf'; groupObjectIds = @($other, $tier0) } $member | Should -Be 'True' } } Context 'membership mode (RE-007)' { It 'answers a direct question from direct data' { $u = New-TestUser -Membership (New-PersonaMembershipRecord -DirectGroupObjectIds @($tier0) -DirectRetrieved) Test-Op @{ type = 'membership'; operator = 'memberOf'; membershipMode = 'Direct'; groupObjectIds = @($tier0) } $u | Should -Be 'True' } It 'returns Unknown when asked a transitive question with only direct data' { # Transitive is a superset of direct, so answering from direct data # would produce false negatives on nested groups. $u = New-TestUser -Membership (New-PersonaMembershipRecord -DirectGroupObjectIds @($tier0) -DirectRetrieved) Test-Op @{ type = 'membership'; operator = 'memberOf'; membershipMode = 'Transitive'; groupObjectIds = @($tier0) } $u | Should -Be 'Unknown' } It 'returns Unknown when asked a direct question with only transitive data' { $u = New-TestUser -Membership (New-PersonaMembershipRecord -TransitiveGroupObjectIds @($tier0) -TransitiveRetrieved) Test-Op @{ type = 'membership'; operator = 'memberOf'; membershipMode = 'Direct'; groupObjectIds = @($tier0) } $u | Should -Be 'Unknown' } It 'falls back to the engine default mode when the condition omits one' { $u = New-TestUser -Membership (New-PersonaMembershipRecord -TransitiveGroupObjectIds @($tier0) -TransitiveRetrieved) Test-Op @{ type = 'membership'; operator = 'memberOf'; groupObjectIds = @($tier0) } $u 'Transitive' | Should -Be 'True' } } Context 'role conditions' { It 'matches a held directory role' { $u = New-TestUser -Membership (New-PersonaMembershipRecord -DirectoryRoleIds @('') -RolesRetrieved) Test-Op @{ type = 'role'; operator = 'memberOf'; roleIds = @('') } $u | Should -Be 'True' } It 'is not affected by membership mode' { # Role assignments have no direct/transitive distinction in this model. $u = New-TestUser -Membership (New-PersonaMembershipRecord -DirectoryRoleIds @('') -RolesRetrieved) Test-Op @{ type = 'role'; operator = 'memberOf'; roleIds = @('') } $u 'Direct' | Should -Be 'True' } } }