refactor: fix proxy system and introduce psalm extension

[nikophil]

fixes #701 #696

I've decided to completely remove all methods in PersistenceProxyObjectFactory, so we do not override @final methods anymore. We still need to figure out a solution for PersistenceObjectFactory::create(), I'll do this in a further PR.

Psalm does not understand the following:

/**
 * @extends PersistentProxyObjectFactory<User>
 */
class UserFactory extends PersistentProxyObjectFactory{}

/**
 * @template T of object
 * @extends PersistentObjectFactory<T&Proxy<T>>
 */
abstract class PersistentProxyObjectFactory extends PersistentObjectFactory{}

/**
 * @template T of object
 */
abstract class PersistentObjectFactory{}

it always consider the template to be User and not User&Proxy<User>. I think because we're breaking covariance (T&Proxy<T> is wider than T)

I've finally decided to introduce a psalm extension, we will be able to fix nearly every typing problem in here.

[kbond]

Looks good! I'm unfamiliar with psalm plugins, will this be auto-registered in projects using foundry and psalm?

[nikophil]

I'm unfamiliar with psalm plugins, will this be auto-registered in projects using foundry and psalm?

yes, thanks to the change in composer.json

[deluxetom]

Great solution, thank you!

[nikophil]

everytime we use phpstan pseudo types, we should use @phpstan- annotations because Psalm seems to not understand it

and moreover, see this comment from stof here, I think it is relevant

I'll make another PR where I fix all of the related docblocks

[nikophil]

it seems like PHPStorm does not only interprets methods signature (like PHPStan would do) but it events guesses stuff from the methods' body. I had really hard times to find but it basically fixes 90% of auto-complete problems 🎉

[nikophil]

same, this is here to help auto-complete