Add Message Object Access in Interceptors for gRPC Component

Overview

This pull request introduces a significant enhancement to the gRPC component. Previously, interceptors could only access incoming requests as binary strings. This limitation restricted the ability to analyze and manipulate request data effectively.

<?php

declare(strict_types=1);

namespace ...\gRPC\Interceptor\Incoming;

use Spiral\Core\CoreInterceptorInterface;
use Spiral\Core\CoreInterface;
use Spiral\RoadRunner\GRPC\ContextInterface;
use Spiral\RoadRunner\GRPC\ServiceInterface;

final class SomeInterceptor implements CoreInterceptorInterface
{
    /**
     * @param array{service: ServiceInterface, ctx: ContextInterface, input: string} $parameters
     */
    public function process(string $controller, string $action, array $parameters, CoreInterface $core): mixed
    {
        dump($parameters['input']);

        return $core->callAction($controller, $action, $parameters);
    }
}

Key Changes

Access to Message Objects: The update enables interceptors to access the Message object of incoming requests directly. This enhancement opens up new possibilities for request analysis and manipulation.
Improved Validation Capabilities: With access to Message objects, it's now feasible to implement more sophisticated validation logic. For example, we can integrate libraries like protoc-gen-validate to enforce request validation based on specific message values.

<?php

declare(strict_types=1);

namespace ...\gRPC\Interceptor\Incoming;

use Spiral\Core\CoreInterceptorInterface;
use Spiral\Core\CoreInterface;
use Spiral\RoadRunner\GRPC\ContextInterface;
use Spiral\RoadRunner\GRPC\ServiceInterface;
use Google\Protobuf\Internal\Message;

final class SomeInterceptor implements CoreInterceptorInterface
{
    /**
     * @param array{
     *     service: ServiceInterface, 
     *     ctx: ContextInterface, 
     *     input: string, 
     *     message: Message
     * } $parameters
     */
    public function process(string $controller, string $action, array $parameters, CoreInterface $core): mixed
    {
        dump($parameters['message']);

        return $core->callAction($controller, $action, $parameters);
    }
}

Impact

This improvement allows developers to create more robust and secure applications using the Spiral Framework. By enabling detailed inspection and validation of incoming requests, we enhance both the flexibility and security of the gRPC component.

Q	A
Bugfix?	❌
Breaks BC?	❌
New feature?	✔️
Issues	#90

I welcome feedback and further suggestions on this enhancement.

spiral / roadrunner-bridge