logger->info("[{$type}] Executing {$actionName}", [ 'action' => $executableClass, 'input' => $input::class, ]); try { if ($executable instanceof Action) { $this->assertInputIsAction($input); $lockedAttribute = $this->resolveLockedAttribute($executable); if ($lockedAttribute !== null) { return $this->executeWithLock($executable, $input, $actionName, $lockedAttribute); } return $this->executeWithoutLock($executable, $input, $actionName); } $this->assertInputIsQuery($input); return $this->executeQuery( $executable, $input, $actionName ); } catch (\Throwable $e) { $this->logger->error("[{$type}] Failed {$actionName}: {$e->getMessage()}", [ 'action' => $executableClass, 'input' => $input::class, 'message' => $e->getMessage(), 'exception' => $e, ]); throw $e; } } /** * @template TQuery of Query * @template TQueryInput of QueryInput * * @param TQuery $executable * @param TQueryInput $input */ private function executeQuery(Query $executable, QueryInput $input, string $actionName): mixed { $result = $executable($input); $this->logger->info("[Query] Succeeded {$actionName}"); return $result; } /** * @template TAction of Action * * @param TAction $executable */ private function resolveLockedAttribute(Action $executable): ?Locked { $reflection = new \ReflectionClass($executable); $attributes = $reflection->getAttributes(Locked::class); return ($attributes[0] ?? null)?->newInstance(); } /** * @template TAction of Action * * @param TAction $executable */ private function hasWithoutTransactionAttribute(Action $executable): bool { $reflection = new \ReflectionClass($executable); return $reflection->getAttributes(WithoutTransaction::class) !== []; } /** * @template TAction of Action * @template TActionInput of ActionInput * * @param TAction $executable * @param TActionInput $input */ private function executeWithLock( Action $executable, ActionInput $input, string $actionName, Locked $locked, ): mixed { $lockKey = $executable instanceof ProvidesLockKey ? $executable->lockKey($input) : ($locked->key ?? $executable::class); try { $result = $this->lock->synchronize( key: $lockKey, callback: fn (): mixed => $this->executeWithinTransaction($executable, $input, $actionName), ttlSeconds: $locked->ttlSeconds, waitSeconds: $locked->waitSeconds, ); } catch (LockTimeoutException $e) { if ($executable instanceof HandlesLockTimeout) { $this->logger->warning("[Action] Lock timeout {$actionName}", [ 'action' => $executable::class, 'input' => $input::class, 'lockKey' => $lockKey, 'message' => $e->getMessage(), ]); return $executable->onLockTimeout($input); } $this->runFailureHook($executable, $input, $e); throw $e; } catch (\Throwable $e) { $this->runFailureHook($executable, $input, $e); throw $e; } $this->runPostCommitHooks($executable, $input, $result); return $result; } /** * @template TAction of Action * @template TActionInput of ActionInput * * @param TAction $executable * @param TActionInput $input */ private function executeWithoutLock( Action $executable, ActionInput $input, string $actionName, ): mixed { try { $result = $this->executeWithinTransaction($executable, $input, $actionName); } catch (\Throwable $e) { $this->runFailureHook($executable, $input, $e); throw $e; } $this->runPostCommitHooks($executable, $input, $result); return $result; } /** * @template TAction of Action * @template TActionInput of ActionInput * * @param TAction $executable * @param TActionInput $input */ private function runFailureHook( Action $executable, ActionInput $input, \Throwable $exception, ): void { if ($executable instanceof HandlesFailure) { $executable->onFailure($input, $exception); } } /** * @template TAction of Action * @template TActionInput of ActionInput * * @param TAction $executable * @param TActionInput $input */ private function executeWithinTransaction(Action $executable, ActionInput $input, string $actionName): mixed { $this->eventDispatcher->beginBuffering(); $run = function () use ($executable, $input, $actionName): mixed { $result = $executable($input); $this->logger->info("[Action] Succeeded {$actionName}"); return $result; }; try { return $this->hasWithoutTransactionAttribute($executable) ? $run() : DB::transaction($run); } catch (\Throwable $e) { $this->eventDispatcher->discard(); throw $e; } } /** * @template TAction of Action * @template TActionInput of ActionInput * * @param TAction $executable * @param TActionInput $input */ private function runPostCommitHooks(Action $executable, ActionInput $input, mixed $result): void { $this->eventDispatcher->flush(); if ($executable instanceof HandlesSuccess) { $executable->onSuccess($input, $result); } } /** * @psalm-assert QueryInput $input */ private function assertInputIsQuery(mixed $input): void { if (! $input instanceof QueryInput) { throw new \InvalidArgumentException('Input must be an instance of QueryInput.'); } } /** * @psalm-assert ActionInput $input */ private function assertInputIsAction(mixed $input): void { if (! $input instanceof ActionInput) { throw new \InvalidArgumentException('Input must be an instance of ActionInput.'); } } }