feat: Add IS_NULL and IS_NOT_NULL operators for rule null handling

[Copilot]

Overview

This PR adds comprehensive null handling support to Maintainerr rules, allowing users to explicitly match on null values and fixing the boolean logic bug identified in PR #1857.

Key Changes

🐛 Boolean Logic Fix

Fixed the boolean logic bug from PR #1857:

// Before (broken):
if ((firstVal !== undefined || null) && (secondVal !== undefined || null)) {
    // || null always evaluates to null (falsy), breaking the logic
}

// After (fixed):
if ((firstVal !== undefined && firstVal !== null) && (secondVal !== undefined && secondVal !== null)) {
    // Proper null checking
}

✨ New Null Operators

Added two new operators to RulePossibility enum:

• IS_NULL (value: 18) - Matches values that are explicitly null
• IS_NOT_NULL (value: 19) - Matches values that are not null

🔧 Smart Processing Logic

Enhanced rule execution to allow null values for null-specific operators while preserving existing behavior:

const allowsNullValues = [RulePossibility.IS_NULL, RulePossibility.IS_NOT_NULL].includes(rule.action);
const hasValidValues = allowsNullValues || 
  ((firstVal !== undefined && firstVal !== null) &&
   (secondVal !== undefined && secondVal !== null));

🎯 New Rule Type

Added RuleType.NULL (ID: 5) specifically for null operations, ensuring type safety and proper UI integration.

Use Cases

Users can now create rules like:

- Find unrated movies: "Plex rating IS_NULL"
- Find watched content: "Last viewed date IS_NOT_NULL"  
- Find unrequested media: "Overseerr request date IS_NULL"
- Find content with metadata: "Movie description IS_NOT_NULL"

Testing

• ✅ 22 new tests covering all null handling scenarios
• ✅ 174 total tests passing across all rule modules
• ✅ Backwards compatibility verified - all existing functionality preserved
• ✅ Edge cases covered - null vs undefined vs empty string distinctions

Backwards Compatibility

This is a non-breaking change:

• All existing rules continue to work unchanged
• New operators are additive functionality
• Existing null-skipping behavior preserved for non-null operators

Example Usage

// New null-specific operators
ruleComparator.doRuleAction(null, null, RulePossibility.IS_NULL);        // true
ruleComparator.doRuleAction('text', null, RulePossibility.IS_NULL);      // false
ruleComparator.doRuleAction(null, null, RulePossibility.IS_NOT_NULL);    // false
ruleComparator.doRuleAction('text', null, RulePossibility.IS_NOT_NULL);  // true

// Existing operators still work
ruleComparator.doRuleAction('test', 'test', RulePossibility.EQUALS);     // true

Fixes #1894.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.