reduce▌

Refactor a method to reduce cognitive complexity by extracting helper methods. \n \n Analyzes nested conditionals, loops, and complex boolean expressions to identify refactoring opportunities \n Extracts validation logic, type-specific processing, and repeated code blocks into focused helper methods \n Simplifies the main method flow while preserving all original functionality and error handling \n Includes mandatory test verification to confirm zero test failures and cognitive complexity at or