TR
games/runtime-demo / tests / RuntimeClientTest.php · commit 459a354
<?phpnamespace Tests;use JumPHP\Bridge\JsBridge;use JumPHP\Kernel\GameConfig;use JumPHP\Net\RuntimeLink;use JumPHP\Runtime\RuntimeClient;use PHPUnit\Framework\TestCase;/** The client's state machine, fed with the page's 'runtime' events (no browser, no window). */final class RuntimeClientTest extends TestCase{    private JsBridge $bridge;    private function client(): RuntimeClient    {        $this->bridge = new JsBridge();        return new RuntimeClient($this->bridge, new GameConfig(['id' => 'sql', 'title' => 'SQL']), true);    }    private function page(array $event): void    {        $this->bridge->emit('runtime', [$event]);    }    public function testItStartsUnknownAndCheckingMovesItOn(): void    {        $c = $this->client();        self::assertSame(RuntimeLink::UNKNOWN, $c->state());        $changes = [];        $c->on('change', function (string $s) use (&$changes): void { $changes[] = $s; });        $task = $c->check();        self::assertSame(RuntimeLink::CHECKING, $c->state());        $this->page(['ev' => 'hello', 'port' => 47822, 'runtime' => '0.1.0', 'os' => 'linux', 'granted' => false, 'apps' => []]);        self::assertSame(RuntimeLink::RUNNING, $c->state());        self::assertSame(RuntimeLink::RUNNING, $task->result());        self::assertSame('ws://127.0.0.1:47822/v1', $c->bridgeUrl());        self::assertSame('0.1.0', $c->version());        self::assertSame('linux', $c->os());        self::assertSame([RuntimeLink::CHECKING, RuntimeLink::RUNNING], $changes);    }    public function testABlockedBrowserIsToldApartFromAMissingRuntime(): void    {        $c = $this->client();        $c->check();        $this->page(['ev' => 'blocked', 'why' => 'no']);        self::assertSame(RuntimeLink::UNSUPPORTED, $c->state());        self::assertTrue($c->isBlocked());        $c->check();        $this->page(['ev' => 'missing']);        self::assertSame(RuntimeLink::MISSING, $c->state());        self::assertFalse($c->isBlocked());    }    public function testAutoConnectLooksAgainWhenMissingAndAsksOnceWhenFound(): void    {        $this->bridge = new class extends JsBridge {            /** @var list<string> */            public array $ops = [];            public function send(string $type, array $data = []): bool            {                $this->ops[] = $data['op'] ?? $type;                return true;            }        };        $c = new RuntimeClient($this->bridge, new GameConfig(['id' => 'sql', 'title' => 'SQL']), true);        $c->autoConnect();        $this->page(['ev' => 'missing']);        $c->update(9.0);                                   // looks again by itself        self::assertSame(['probe', 'probe'], $this->bridge->ops);        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => []]);        self::assertSame(['probe', 'probe', 'pair'], $this->bridge->ops, 'found but not allowed: asks once');        $this->page(['ev' => 'paired', 'granted' => false]);        self::assertSame(RuntimeLink::REFUSED, $c->state());        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => []]);        self::assertSame(RuntimeLink::REFUSED, $c->state(), 'a refusal is respected');        self::assertNotContains('pair', array_slice($this->bridge->ops, 3));    }    public function testAPermissionQuestionInTheBrowserIsNotMissing(): void    {        $c = $this->client();        $c->check();        $c->update(5.0);        $this->page(['ev' => 'pending']);        $c->update(30.0);        self::assertSame(RuntimeLink::CHECKING, $c->state(), 'the probe waits for the answer of the user');        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => []]);        self::assertSame(RuntimeLink::RUNNING, $c->state());        $c->check();        $this->page(['ev' => 'pending']);        $c->update(70.0);        self::assertSame(RuntimeLink::MISSING, $c->state(), 'but not forever');    }    public function testAnAuthorisedApplicationIsReady(): void    {        $c = $this->client();        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'granted' => true, 'apps' => ['other', 'sql']]);        self::assertSame(RuntimeLink::READY, $c->state());    }    public function testNothingListeningMeansMissing(): void    {        $c = $this->client();        $task = $c->check();        $this->page(['ev' => 'missing']);        self::assertSame(RuntimeLink::MISSING, $c->state());        self::assertSame(RuntimeLink::MISSING, $task->result());    }    public function testASilentPageMeansMissingAfterTheTimeout(): void    {        $c = $this->client();        $c->check();        $c->update(3.0);        self::assertSame(RuntimeLink::CHECKING, $c->state());        $c->update(4.0);        self::assertSame(RuntimeLink::MISSING, $c->state());    }    public function testABrowserThatBlocksIsUnsupported(): void    {        $c = $this->client();        $c->check();        $this->page(['ev' => 'blocked', 'why' => 'mixed content']);        self::assertSame(RuntimeLink::UNSUPPORTED, $c->state());    }    public function testPairingAsksTheRuntimeAndFollowsTheAnswer(): void    {        $c = $this->client();        self::assertFalse($c->pair('sql', 'SQL')->result(), 'not running: nothing to ask');        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => []]);        $answer = null;        $c->pair('sql', 'SQL')->then(function ($granted) use (&$answer): void { $answer = $granted; });        $this->page(['ev' => 'paired', 'app' => 'sql', 'granted' => true, 'always' => true]);        self::assertTrue($answer);        self::assertSame(RuntimeLink::READY, $c->state());        $c = $this->client();        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => []]);        $c->pair('sql', 'SQL');        $this->page(['ev' => 'paired', 'app' => 'sql', 'granted' => false]);        self::assertSame(RuntimeLink::REFUSED, $c->state());        // looking again does not hide the refusal: the user must ask again        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => []]);        self::assertSame(RuntimeLink::REFUSED, $c->state());    }    public function testItAsksThePageToProbeOnce(): void    {        $c = $this->client();        $c->check();        $c->check();        self::assertSame(RuntimeLink::CHECKING, $c->state());    }    public function testNotInABrowserItIsAlwaysUnsupported(): void    {        $c = new RuntimeClient(new JsBridge(), new GameConfig(), false);        self::assertSame(RuntimeLink::UNSUPPORTED, $c->state());        self::assertSame(RuntimeLink::UNSUPPORTED, $c->check()->result());        self::assertFalse($c->pair('a', 'A')->result());    }    public function testItKeepsLookingEvenWhenReadyAndAfterAFailure(): void    {        $this->bridge = new class extends JsBridge {            /** @var list<string> */            public array $ops = [];            public function send(string $type, array $data = []): bool            {                $this->ops[] = $data['op'] ?? $type;                return true;            }        };        $c = new RuntimeClient($this->bridge, new GameConfig(['id' => 'sql', 'title' => 'SQL']), true);        $c->autoConnect();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => ['sql']]);        self::assertSame(RuntimeLink::READY, $c->state());        $c->update(10.0);        self::assertSame(['probe'], $this->bridge->ops, 'calm while ready: not yet');        $c->update(11.0);        self::assertSame(['probe', 'probe'], $this->bridge->ops, 'looks again every 20 seconds even when ready');        $this->page(['ev' => 'missing']);        self::assertSame(RuntimeLink::MISSING, $c->state(), 'the runtime stopped: the badge follows');        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => ['sql']]);        $c->reportFailure();        self::assertSame(['probe', 'probe', 'probe'], $this->bridge->ops, 'a failed connection makes it look at once');    }    public function testTheUsersChoiceOfTheProxyIsHonouredByTheRoute(): void    {        $c = $this->client();        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => ['sql']]);        self::assertSame('ws://127.0.0.1:47820/v1', \JumPHP\Net\BridgeRoute::resolve('auto', $c, 'wss://server/tcp'));        $c->setUseServer(true);        self::assertSame('wss://server/tcp', \JumPHP\Net\BridgeRoute::resolve('auto', $c, 'wss://server/tcp'));        self::assertSame('ws://127.0.0.1:47820/v1', \JumPHP\Net\BridgeRoute::resolve('local', $c, 'wss://server/tcp'), 'local mode means local');    }    public function testAnAndroidAppThatDoesNotAnswerIsWokenFromTheServer(): void    {        $c = $this->client();        $woken = [];        $c->setWaker(function (string $token) use (&$woken): void { $woken[] = $token; });        $learned = [];        $c->on('push', function (string $t) use (&$learned): void { $learned[] = $t; });        $this->page(['ev' => 'env', 'os' => 'android']);        $c->check();        $this->page(['ev' => 'hello', 'port' => 47820, 'apps' => ['sql'], 'push' => 'TOKEN-1']);        self::assertSame(['TOKEN-1'], $learned, 'the app gives its token in its hello');        self::assertSame([], $woken, 'it answers: nothing to wake');        $c->check();        $this->page(['ev' => 'missing']);        self::assertSame(['TOKEN-1'], $woken, 'it does not answer any more: the server is asked to wake it');        $c->check();        $this->page(['ev' => 'missing']);        self::assertCount(1, $woken, 'not again within 90 seconds');        $c->update(95.0);        $c->check();        $this->page(['ev' => 'missing']);        self::assertCount(2, $woken);    }    public function testWithoutAPhoneTokenNothingIsAsked(): void    {        $c = $this->client();        $woken = 0;        $c->setWaker(function () use (&$woken): void { $woken++; });        $this->page(['ev' => 'env', 'os' => 'android']);        $c->check();        $this->page(['ev' => 'missing']);        self::assertSame(0, $woken);    }}