refactor: update union types with null

Improve readability and interpretability of code by explicitly stating null in union types. This
change has been applied across multiple files and functions.

PHP8.4 compatibility