feat: implement "FOR UPDATE OF" for postgres driver

[ejose19]

Description of change

Fixes #4084

This PR implements some parts of the unmerged #5253 PR, improving it to allow specifying multiple tables and checking whether the referenced tables exists in the query.

Also, there are some improvements to related methods JSDocs/Type definitions, removing invalid where space, and adding missing lock mode to FindOptions.

Note for whoever want to implement this for other drivers

• Oracle uses a different syntax, specifying table.column or column instead of table after the OF clause, so an special treatment needs to be done when oracle is the driver. source1 source2

• MySQL / Aurora do indeed support this syntax in their latest versions, but tests are using an outdated version of them, so a new updated image is needed for properly testing the feature. source

• MySQL / Aurora in their latest version does not need to use a different if for return " LOCK IN SHARE MODE";, as they support the FOR SHARE syntax. *same source as above

• MySQL / Aurora / Oracle supports SKIP LOCKED and NOWAIT, so when new tests images are added they can be included in the corresponding if. *same sources as above

Pull-Request Checklist

• Code is up-to-date with the master branch
• npm run lint passes with this change
• npm run test passes with this change
• This pull request links relevant issues as Fixes #0000
• There are new or updated unit tests validating the change
• Documentation has been updated to reflect this change
• The new commits follow conventions explained in CONTRIBUTING.md

[AlexMesser]

thank you for contribution!

[herenickname]

can you add a version of setLock without lockVersion param?

[ejose19]

You should use typescript, null is not a valid value to be passed as 2nd argument. It gives an error: Argument of type 'null' is not assignable to parameter of type 'undefined'.ts(2345)

The way the original setLock is designed, you need to pass undefined as 2nd argument if you want to use lockTables, changing it would be a breaking change and one that wouldn't have been merged into this major release of typeorm.

[herenickname]

You should use typescript, null is not a valid value to be passed as 2nd argument. It gives an error: Argument of type 'null' is not assignable to parameter of type 'undefined'.ts(2345)

The way the original setLock is designed, you need to pass undefined as 2nd argument if you want to use lockTables, changing it would be a breaking change and one that wouldn't have been merged into this major release of typeorm.

I have tried undefined before null. Anyway, I found a bug, it's on my side, thanks for this feature!