feat: add gRPC client support and configuration

Author: hungthai1401

composer.json

@@ -42,7 +42,8 @@
         "spiral/roadrunner-http": "^3.0",
         "spiral/roadrunner-worker": "^3.0",
         "temporal/sdk": "^2.0",
-        "internal/dload": "^1.1"
+        "internal/dload": "^1.1",
+        "spiral/grpc-client": "^1.0.0-rc1"
     },
     "require-dev": {
         "laravel/framework": "^12.0",

config/roadrunner.php

@@ -18,6 +18,31 @@
         'services' => [
             // GreeterInterface::class => new Greeter::class,
         ],
+        'clients' => [
+            'interceptors' => [
+                // LoggingInterceptor::class,
+            ],
+            'services' => [
+                // [
+                //     'connection' => 'my-grpc-server:9002',
+                //     'interfaces' => [
+                //         GreeterInterface::class,
+                //     ],
+                // ],
+                // [
+                //     'connection' => 'my-secure-grpc-server:9002',
+                //     'interfaces' => [
+                //         GreeterInterface::class,
+                //     ],
+                //     'tls' => [
+                //         'rootCerts' => '/path/to/ca.pem',
+                //         'privateKey' => '/path/to/client.key',
+                //         'certChain'  => '/path/to/client.crt',
+                //         'serverName' => 'my.grpc.server',
+                //     ],
+                // ],
+            ],
+        ],
     ],
 
     'temporal' => [

src/ServiceProvider.php

@@ -6,6 +6,12 @@
 
 use Spiral\Attributes\AttributeReader;
 use Spiral\Attributes\ReaderInterface;
+use Spiral\Core\FactoryInterface;
+use Spiral\Grpc\Client\Config\ConnectionConfig;
+use Spiral\Grpc\Client\Config\GrpcClientConfig;
+use Spiral\Grpc\Client\Config\ServiceConfig;
+use Spiral\Grpc\Client\Config\TlsConfig;
+use Spiral\Grpc\Client\ServiceClientProvider;
 
 final class ServiceProvider extends \Illuminate\Support\ServiceProvider
 {
@@ -23,6 +29,7 @@ public function register(): void
     {
         $this->app->singleton(ReaderInterface::class, AttributeReader::class);
         $this->initializeConfigs();
+        $this->initializeGrpcClientServices();
     }
 
     protected function initializeConfigs(): void
@@ -33,4 +40,66 @@ protected function initializeConfigs(): void
             \realpath(self::getConfigPath()) => config_path(\basename(self::getConfigPath())),
         ], 'config');
     }
+
+    protected function initializeGrpcClientServices(): void
+    {
+        $this->app->singleton(FactoryInterface::class, fn() => new class implements FactoryInterface {
+            /**
+             * @param  class-string  $class
+             * @param  array<int, mixed>  $parameters
+             */
+            public function make(string $class, array $parameters = []): object
+            {
+                return new $class(...array_values($parameters));
+            }
+        });
+        $this->app->singleton(ServiceClientProvider::class, function () {
+            $toNonEmptyStringOrNull = static fn($value): ?string => (is_string($value) && $value !== '') ? $value : null;
+            /**
+             * @var array<int, array{
+             *     connection: non-empty-string,
+             *     interfaces: list<class-string>,
+             *     tls?: array{
+             *         rootCerts?: non-empty-string|null,
+             *         privateKey?: non-empty-string|null,
+             *         certChain?: non-empty-string|null,
+             *         serverName?: non-empty-string|null
+             *     }
+             * }>
+             */
+            $rawServices = config('roadrunner.grpc.clients.services', []);
+            $services = collect($rawServices);
+            $serviceConfigs = [];
+            foreach ($services as $service) {
+                $tls = null;
+                if (isset($service['tls'])) {
+                    $tlsConfig = $service['tls'];
+                    $tls = new TlsConfig(
+                        $toNonEmptyStringOrNull($tlsConfig['rootCerts'] ?? null),
+                        $toNonEmptyStringOrNull($tlsConfig['privateKey'] ?? null),
+                        $toNonEmptyStringOrNull($tlsConfig['certChain'] ?? null),
+                        $toNonEmptyStringOrNull($tlsConfig['serverName'] ?? null),
+                    );
+                }
+                /** @var non-empty-string $connection */
+                $connection = $service['connection'];
+                /** @var list<class-string> $interfaces */
+                $interfaces = $service['interfaces'];
+                $serviceConfigs[] = new ServiceConfig(
+                    connections: new ConnectionConfig($connection, $tls),
+                    interfaces: $interfaces,
+                );
+            }
+
+            /** @var array<class-string<\Spiral\Interceptors\InterceptorInterface>|\Spiral\Core\Container\Autowire<\Spiral\Interceptors\InterceptorInterface>|\Spiral\Interceptors\InterceptorInterface> $interceptors */
+            $interceptors = config('roadrunner.grpc.clients.interceptors', []);
+            $config = new GrpcClientConfig(
+                interceptors: $interceptors,
+                services: $serviceConfigs,
+            );
+
+            return new ServiceClientProvider($config, $this->app->make(FactoryInterface::class));
+        });
+
+    }
 }