Implementation of scopes

[msmakouz]

What was changed

Added a temporal scope to the dispatcher. Added opening of the temporal.activity scope when creating an activity. Now it is possible to define a scope for an activity and register dependencies in the container so that they are only available within the temporal.activity scope.

For example, let's create an activity and specify the temporal.activity scope for it:

use Psr\Container\ContainerInterface;
use Spiral\Core\Attribute\Scope;
use Spiral\Framework\Spiral;
use Temporal\Activity\ActivityInterface;
use Temporal\Activity\ActivityMethod;

#[Scope(Spiral::TemporalActivity)] // <------------
#[ActivityInterface]
class PingWebsiteActivity
{
    public function __construct(
        private readonly ContainerInterface $container,
    ) {
        trap($this->container); // container here must be in the temporal.activity scope
    }

    #[ActivityMethod(name: 'ping')]
    public function ping(string $domain): bool
    {
        // ...
    }
}

After that, we will define the binding of the activity within the temporal.activity scope:

use App\Endpoint\Temporal\Activity\PingWebsiteActivity;
use Spiral\Boot\Bootloader\Bootloader;
use Spiral\Core\BinderInterface;
use Spiral\Framework\Spiral;

final class AppBootloader extends Bootloader
{
    public function __construct(
        private readonly BinderInterface $binder,
    ) {
    }

    public function defineBindings(): array
    {
        $this->binder
            ->getBinder(Spiral::TemporalActivity)
            ->bind(PingWebsiteActivity::class, PingWebsiteActivity::class);

        return [];
    }
}

As a result, the activity will receive dependencies that are defined within the temporal.activity scope.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.71%. Comparing base (38be446) to head (4b81bbc).

Additional details and impacted files

@@             Coverage Diff              @@
##                3.x      #80      +/-   ##
============================================
+ Coverage     99.14%   99.71%   +0.56%     
- Complexity      103      104       +1     
============================================
  Files            15       15              
  Lines           352      354       +2     
============================================
+ Hits            349      353       +4     
+ Misses            3        1       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.