Leave only *Handler API

Author: antonkomarev

README.md

@@ -11,7 +11,7 @@
 
 - [ ] Do we need handle methods? Or leave simple bool for transaction and callback only for session lock
 - [ ] Should wait mode be blocking or non-blocking by default?
-- [ ] Should callback for session lock be at the end of the params?
+- [ ] Should callback for session lock be at the end of the params (after optional ones)?
 
 ## Introduction
 

src/Postgres/PostgresAdvisoryLocker.php

@@ -94,6 +94,7 @@ public function acquireSessionLevelLock(
      * ⚠️ Transaction-level advisory locks are strongly preferred whenever possible,
      * as they are automatically released at the end of a transaction and are less error-prone.
      * Use session-level locks only when transactional context is not available.
+     * @see acquireTransactionLevelLock() for preferred locking strategy.
      *
      * @param PDO $dbConnection Active database connection.
      * @param PostgresLockKey $key Lock key to be acquired.
@@ -105,8 +106,6 @@ public function acquireSessionLevelLock(
      * @template TReturn
      *
      * TODO: Cover with tests
-     *@see acquireTransactionLevelLock() for preferred locking strategy.
-     *
      */
     public function withinSessionLevelLock(
         PDO $dbConnection,