chore: add more type hinting and psalm

[Bramw2003]

Adds psalm for static analysis and fixes a lot of psalm issues

We had some psalm issues in our code because of this and I thought why not fix it for everyone instead 😄

[icamys]

@Bramw2003 Thank you for your great work! I'm preparing a new version that includes psalm validation. Cheers!