Refactor low-level transactions to `DatabaseTransaction/Repository->t…

…ransaction()` API to handle nested transactions

- Important: It is recommended to update transactions to use new `DatabaseTransaction` API to ensure correct transaction handling within nested transactions.
- Introduced new `DatabaseTransaction` API usable directly via DI or via `Repository->getTransaction()`

remp/crm#3330

src/Models/Auth/Sso/SsoUserManager.php

@@ -37,7 +37,7 @@ public function matchOrCreateUser(
     ): ActiveRow {
         // Transaction may cause hermes event handlers to fail occasionally because the data is not committed into db at the time of event handling.
         // TODO: Return transaction with remp/crm#2218 implementation
-//        $this->dbContext->beginTransaction();
+//        $this->connectedAccountsRepository->getTransaction()->start();
 //        try {
         if ($loggedUserId) {
             $connectedAccount = $this->connectedAccountsRepository->getByExternalId($type, $externalId);
@@ -81,10 +81,10 @@ public function matchOrCreateUser(
             );
         }
 //        } catch (\Exception $e) {
-//            $this->dbContext->rollBack();
+//            $this->connectedAccountsRepository->getTransaction()->rollback();
 //            throw $e;
 //        }
-//        $this->dbContext->commit();
+//        $this->connectedAccountsRepository->getTransaction()->commit();
 
         return $user;
     }

src/Repositories/AccessTokensRepository.php

@@ -36,7 +36,6 @@ public function __construct(
         DataProviderManager $dataProviderManager
     ) {
         parent::__construct($database);
-        $this->database = $database;
         $this->emitter = $emitter;
         $this->userMetaRepository = $userMetaRepository;
         $this->dataProviderManager = $dataProviderManager;

src/Repositories/UserConnectedAccountsRepository.php

@@ -23,7 +23,6 @@ public function __construct(
         AuditLogRepository $auditLogRepository
     ) {
         parent::__construct($database);
-        $this->database = $database;
         $this->auditLogRepository = $auditLogRepository;
     }
 

src/Repositories/UsersRepository.php

@@ -53,7 +53,6 @@ public function __construct(
         Passwords $passwords
     ) {
         parent::__construct($database);
-        $this->database = $database;
         $this->emitter = $emitter;
         $this->auditLogRepository = $auditLogRepository;
         $this->hermesEmitter = $hermesEmmiter;

src/Tests/Repositories/CountriesRepositoryTest.php

@@ -2,6 +2,7 @@
 
 namespace Crm\UsersModule\Tests\Repositories;
 
+use Crm\ApplicationModule\Database\DatabaseTransaction;
 use Crm\ApplicationModule\Seeders\CountriesSeeder;
 use Crm\ApplicationModule\Tests\DatabaseTestCase;
 use Crm\UsersModule\Repositories\CountriesRepository;
@@ -41,6 +42,7 @@ public function testDefaultCountrySuccess()
         // default country set while initializing repository
         $testCountry = 'CZ';
         $countriesRepository = new CountriesRepository($testCountry, $this->inject(Explorer::class));
+        $countriesRepository->setTransaction($this->inject(DatabaseTransaction::class));
         $country = $countriesRepository->defaultCountry();
         $this->assertEquals($testCountry, $country->iso_code);
     }
@@ -61,6 +63,7 @@ public function testDefaultCountryCountryIsoUnknownFailure()
             new \Exception("Unable to load default country from provided ISO code [UNKNOWN].")
         );
         $countriesRepository = new CountriesRepository($testCountry, $this->inject(Explorer::class));
+        $countriesRepository->setTransaction($this->inject(DatabaseTransaction::class));
         $countriesRepository->defaultCountry();
     }
 }