Updated docblock for LockInterface (#698)

* Updated docblock for `LockInterface`

* feat: Refactor `LockInterface` and `AbstractLock` to handle lock timeouts

The code changes in `LockInterface.php` and `AbstractLock.php` refactor the lock functionality to handle lock timeouts. This includes adding a `LockTimeoutException` and updating the `block` method to throw this exception when the lock cannot be acquired within the specified time. This change improves the reliability and error handling of the lock mechanism.

Note: This message has been generated based on the provided code changes and recent commits.

---------

Co-authored-by: Deeka Wong <[email protected]>

src/lock/src/Driver/AbstractLock.php

@@ -52,7 +52,7 @@ abstract public function release(): bool;
 
     /**
      * Attempt to acquire the lock.
-     * @return mixed
+     * {@inheritdoc}
      */
     #[Override]
     public function get(?callable $callback = null)
@@ -72,8 +72,7 @@ public function get(?callable $callback = null)
 
     /**
      * Attempt to acquire the lock for the given number of seconds.
-     * @return mixed
-     * @throws LockTimeoutException
+     * {@inheritdoc}
      */
     #[Override]
     public function block(int $seconds, ?callable $callback = null)

src/lock/src/Driver/LockInterface.php

@@ -11,16 +11,25 @@
 
 namespace FriendsOfHyperf\Lock\Driver;
 
+use FriendsOfHyperf\Lock\Exception\LockTimeoutException;
+
 interface LockInterface
 {
     /**
      * Attempt to acquire the lock.
-     * @return mixed
+     * @template T
+     * @param (callable(): T)|null $callback
+     * @return ($callback is null ? bool : T)
      */
     public function get(?callable $callback = null);
 
     /**
      * Attempt to acquire the lock for the given number of seconds.
+     *
+     * @template T
+     * @param (callable(): T)|null $callback
+     * @return ($callback is null ? bool : T)
+     * @throws LockTimeoutException
      */
     public function block(int $seconds, ?callable $callback = null);