Child process queue workers (#450)

* Child process queue workers
- Remove `ShouldBroadcast` in favor of `ShouldBroadcastNow` in `Events\\ChildProcess` namespace
- Implement `QueueWorker::class`
- Add new binding to `NativeServiceProvider::class`
- Fire up workers: iterate through queue worker config in `NativeServiceProvider::configureApp()`

- Test `QueueWorker::up()`, `QueueWorker::down()`
- Test `QueueWorkerFake::class` assertions work as expected

* Prevent attempting to boot workers on CLI calls

* Remove creating workers just by string

Rely on keys of the config array to assert uniqueness of worker aliases

* Allow workers to be instantiated directly by alias

* Fix styling

* Fix tests

---------

Co-authored-by: Simon Hamp <simon.hamp@me.com>
Co-authored-by: simonhamp <simonhamp@users.noreply.github.com>

Author: XbNz

config/nativephp.php

@@ -114,4 +114,12 @@
             ],
         ],
     ],
+
+    'queue_workers' => [
+        'default' => [
+            'queues' => ['default'],
+            'memory_limit' => 128,
+            'timeout' => 60,
+        ],
+    ],
 ];

src/Contracts/QueueWorker.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Native\Laravel\Contracts;
+
+use Native\Laravel\DTOs\QueueConfig;
+
+interface QueueWorker
+{
+    public function up(QueueConfig $config): void;
+
+    public function down(string $alias): void;
+}

src/DTOs/QueueConfig.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Native\Laravel\DTOs;
+
+class QueueConfig
+{
+    /**
+     * @param  array<int, string>  $queuesToConsume
+     */
+    public function __construct(
+        public readonly string $alias,
+        public readonly array $queuesToConsume,
+        public readonly int $memoryLimit,
+        public readonly int $timeout,
+    ) {}
+
+    /**
+     * @return array<int, self>
+     */
+    public static function fromConfigArray(array $config): array
+    {
+        return array_map(
+            function (array|string $worker, string $alias) {
+                return new self(
+                    $alias,
+                    $worker['queues'] ?? ['default'],
+                    $worker['memory_limit'] ?? 128,
+                    $worker['timeout'] ?? 60,
+                );
+            },
+            $config,
+            array_keys($config),
+        );
+    }
+}

src/Events/ChildProcess/ErrorReceived.php

@@ -3,11 +3,11 @@
 namespace Native\Laravel\Events\ChildProcess;
 
 use Illuminate\Broadcasting\Channel;
-use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
 use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Queue\SerializesModels;
 
-class ErrorReceived implements ShouldBroadcast
+class ErrorReceived implements ShouldBroadcastNow
 {
     use Dispatchable, SerializesModels;
 

src/Events/ChildProcess/MessageReceived.php

@@ -3,11 +3,11 @@
 namespace Native\Laravel\Events\ChildProcess;
 
 use Illuminate\Broadcasting\Channel;
-use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
 use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Queue\SerializesModels;
 
-class MessageReceived implements ShouldBroadcast
+class MessageReceived implements ShouldBroadcastNow
 {
     use Dispatchable, SerializesModels;
 

src/Events/ChildProcess/ProcessExited.php

@@ -3,11 +3,11 @@
 namespace Native\Laravel\Events\ChildProcess;
 
 use Illuminate\Broadcasting\Channel;
-use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
 use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Queue\SerializesModels;
 
-class ProcessExited implements ShouldBroadcast
+class ProcessExited implements ShouldBroadcastNow
 {
     use Dispatchable, SerializesModels;
 

src/Events/ChildProcess/ProcessSpawned.php

@@ -3,11 +3,11 @@
 namespace Native\Laravel\Events\ChildProcess;
 
 use Illuminate\Broadcasting\Channel;
-use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
 use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Queue\SerializesModels;
 
-class ProcessSpawned implements ShouldBroadcast
+class ProcessSpawned implements ShouldBroadcastNow
 {
     use Dispatchable, SerializesModels;
 

src/Facades/QueueWorker.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Native\Laravel\Facades;
+
+use Illuminate\Support\Facades\Facade;
+use Native\Laravel\Contracts\QueueWorker as QueueWorkerContract;
+use Native\Laravel\DTOs\QueueConfig;
+use Native\Laravel\Fakes\QueueWorkerFake;
+
+/**
+ * @method static void up(QueueConfig $config)
+ * @method static void down(string $alias)
+ */
+class QueueWorker extends Facade
+{
+    public static function fake()
+    {
+        return tap(static::getFacadeApplication()->make(QueueWorkerFake::class), function ($fake) {
+            static::swap($fake);
+        });
+    }
+
+    protected static function getFacadeAccessor(): string
+    {
+        self::clearResolvedInstance(QueueWorkerContract::class);
+
+        return QueueWorkerContract::class;
+    }
+}

src/Fakes/QueueWorkerFake.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace Native\Laravel\Fakes;
+
+use Closure;
+use Native\Laravel\Contracts\QueueWorker as QueueWorkerContract;
+use Native\Laravel\DTOs\QueueConfig;
+use PHPUnit\Framework\Assert as PHPUnit;
+
+class QueueWorkerFake implements QueueWorkerContract
+{
+    /**
+     * @var array<int, QueueConfig>
+     */
+    public array $ups = [];
+
+    /**
+     * @var array<int, string>
+     */
+    public array $downs = [];
+
+    public function up(QueueConfig $config): void
+    {
+        $this->ups[] = $config;
+    }
+
+    public function down(string $alias): void
+    {
+        $this->downs[] = $alias;
+    }
+
+    public function assertUp(Closure $callback): void
+    {
+        $hit = empty(
+            array_filter(
+                $this->ups,
+                fn (QueueConfig $up) => $callback($up) === true
+            )
+        ) === false;
+
+        PHPUnit::assertTrue($hit);
+    }
+
+    public function assertDown(string|Closure $alias): void
+    {
+        if (is_callable($alias) === false) {
+            PHPUnit::assertContains($alias, $this->downs);
+
+            return;
+        }
+
+        $hit = empty(
+            array_filter(
+                $this->downs,
+                fn (string $down) => $alias($down) === true
+            )
+        ) === false;
+
+        PHPUnit::assertTrue($hit);
+    }
+}

src/NativeServiceProvider.php

@@ -17,7 +17,9 @@
 use Native\Laravel\Contracts\ChildProcess as ChildProcessContract;
 use Native\Laravel\Contracts\GlobalShortcut as GlobalShortcutContract;
 use Native\Laravel\Contracts\PowerMonitor as PowerMonitorContract;
+use Native\Laravel\Contracts\QueueWorker as QueueWorkerContract;
 use Native\Laravel\Contracts\WindowManager as WindowManagerContract;
+use Native\Laravel\DTOs\QueueConfig;
 use Native\Laravel\Events\EventWatcher;
 use Native\Laravel\Exceptions\Handler;
 use Native\Laravel\GlobalShortcut as GlobalShortcutImplementation;
@@ -73,6 +75,10 @@ public function packageRegistered()
             return $app->make(PowerMonitorImplementation::class);
         });
 
+        $this->app->bind(QueueWorkerContract::class, function (Foundation $app) {
+            return $app->make(QueueWorker::class);
+        });
+
         if (config('nativephp-internal.running')) {
             $this->app->singleton(
                 \Illuminate\Contracts\Debug\ExceptionHandler::class,
@@ -112,6 +118,11 @@ protected function configureApp()
 
         config(['session.driver' => 'file']);
         config(['queue.default' => 'database']);
+
+        // XXX: This logic may need to change when we ditch the internal web server
+        if (! $this->app->runningInConsole()) {
+            $this->fireUpQueueWorkers();
+        }
     }
 
     protected function rewriteStoragePath()
@@ -210,4 +221,13 @@ protected function configureDisks(): void
             ]);
         }
     }
+
+    protected function fireUpQueueWorkers(): void
+    {
+        $queueConfigs = QueueConfig::fromConfigArray(config('nativephp.queue_workers'));
+
+        foreach ($queueConfigs as $queueConfig) {
+            $this->app->make(QueueWorkerContract::class)->up($queueConfig);
+        }
+    }
 }