Continue API improvement

[antonkomarev]

No description provided.

[Copilot]

Pull Request Overview

This PR refactors the PostgreSQL advisory lock API to improve consistency and usability. The main focus is on improving method naming, variable naming consistency, and simplifying the API surface.

• Renames variables and parameters for consistency (postgresLockId → lockKey, postgresLockKey)
• Removes the TransactionLevelLockHandle class and simplifies transaction-level lock acquisition
• Adds a new withinSessionLevelLock method for safer session-level lock handling with automatic cleanup

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
test/Unit/Postgres/PostgresLockKeyTest.php	Updates test method and data provider names to use consistent "LockKey" terminology
test/Integration/Postgres/PostgresAdvisoryLockerTest.php	Updates variable names and adapts tests to new API changes including lock handle property access
test/Integration/AbstractIntegrationTestCase.php	Renames parameters and improves lock mode matching logic
src/Postgres/PostgresAdvisoryLocker.php	Major API refactoring: removes handler methods, adds withinSessionLevelLock, simplifies parameter names
src/Postgres/LockHandle/TransactionLevelLockHandle.php	Removes entire file as part of API simplification
src/Postgres/LockHandle/SessionLevelLockHandle.php	Updates property name and removes automatic destructor cleanup
src/Postgres/Enum/PostgresLockWaitModeEnum.php	Reorders documentation comments
src/Postgres/Enum/PostgresLockLevelEnum.php	Reorders enum cases and documentation
src/Postgres/Enum/PostgresLockAccessModeEnum.php	Removes string values from enum, simplifying to basic enum cases
README.md	Updates documentation to reflect API changes and adds new callback-based usage examples