Adds transaction labels and enhanced logging.

Improves debugging capabilities by adding transaction labels to logs for easier identification.

Enhances logging with SQL query information, improving visibility into database operations.

Updates documentation with installation instructions and usage examples.

Author: Ahed92Wakim

README.md

@@ -7,26 +7,36 @@ Features:
 - Exponential backoff with jitter between attempts
 - Structured logging per attempt to storage/logs
 - Safe in HTTP, CLI and queue contexts (request info captured when available)
+- Transaction labeling for easier debugging
+- Enhanced logging with SQL query information
 
 Installation:
-- Require the package via Composer and ensure Laravel auto-discovers the service provider (already configured).
+- Require the package via Composer: `composer require ahed92wakim/laravel-mysql-deadlock-retry`
 
 Usage:
 
-```
+```php
 use MysqlDeadlocks\RetryHelper\DBTransactionRetryHelper as Retry;
 
 $result = Retry::transactionWithRetry(function () {
     // Your DB logic here (queries, models, etc.)
     // Return any value and it will be returned from transactionWithRetry
-}, maxRetries: 3, retryDelay: 2, logFileName: 'mysql-deadlocks-log');
+}, maxRetries: 3, retryDelay: 2, logFileName: 'mysql-deadlocks', trxLabel: 'user-update');
 ```
 
 Parameters:
 - maxRetries: number of attempts (default 3)
 - retryDelay: base delay in seconds; actual wait uses exponential backoff with jitter (default 2)
-- logFileName: file prefix under storage/logs/{today date} (default 'mysql-deadlocks.log')
+- logFileName: file prefix under storage/logs/{today date} (default 'database/mysql-deadlocks')
+- trxLabel: transaction label for easier identification in logs (default '')
+
+Logging:
+- Logs are stored in storage/logs/{date}/ directory
+- Successful transactions after retries are logged as warnings
+- Failed transactions after all retries are logged as errors
+- Logs include SQL queries, stack traces, and request information when available
 
 Notes:
 - Non-deadlock QueryException is thrown immediately.
 - When attempts are exhausted, the last QueryException is thrown; if somehow no exception was thrown, a RuntimeException is raised.
+- Requires PHP 8.2+ and Laravel 11.0+

src/DBTransactionRetryHelper.php

@@ -24,6 +24,9 @@ class DBTransactionRetryHelper
      */
     public static function transactionWithRetry(Closure $callback, int $maxRetries = 3, int $retryDelay = 2, string $logFileName = 'database/mysql-deadlocks', string $trxLabel = ''): mixed
     {
+        if (is_null($trxLabel)){
+            $trxLabel = '';
+        }
         $attempt = 0;
         $log = [];
         $isDeadlock = false;
@@ -34,6 +37,7 @@ public static function transactionWithRetry(Closure $callback, int $maxRetries =
 
             try {
                 // Execute the transaction
+                $trxLabel === '' || app()->instance('tx.label', $trxLabel);
                 $result = DB::transaction($callback);
                 return $result;