XC_VM/tests/Unit/ModuleUpdateCheckerTest.php

<?php

use XcVm\Core\Module\ModuleUpdateChecker;
use PHPUnit\Framework\TestCase;

/**
 * Network-free coverage of the source routing + guards. The actual git/url
 * fetches are integration concerns (they hit the network) and are not exercised
 * here — only the branches that resolve without any HTTP call.
 */
final class ModuleUpdateCheckerTest extends TestCase {

    private ModuleUpdateChecker $checker;

    protected function setUp(): void {
        $this->checker = new ModuleUpdateChecker();
    }

    public function testBundledReturnsOnDiskVersion(): void {
        $result = $this->checker->latestAvailable([
            'update'            => ['source' => 'bundled'],
            'version'           => '1.2.0',
            'installed_version' => '1.0.0',
        ]);
        $this->assertSame('1.2.0', $result);
    }

    public function testAbsentUpdateBlockTreatedAsBundled(): void {
        $result = $this->checker->latestAvailable([
            'version'           => '2.0.0',
            'installed_version' => '1.0.0',
        ]);
        $this->assertSame('2.0.0', $result);
    }

    public function testUrlSourceRejectsNonHttps(): void {
        $result = $this->checker->latestAvailable([
            'update'            => ['source' => 'url', 'url' => 'http://example.com/version.json'],
            'installed_version' => '1.0.0',
        ]);
        $this->assertNull($result); // https-only guard, no network
    }

    public function testGitSourceWithInvalidRepoReturnsNull(): void {
        $result = $this->checker->latestAvailable([
            'update'            => ['source' => 'git', 'repository' => 'not-a-github-url'],
            'installed_version' => '1.0.0',
        ]);
        $this->assertNull($result); // regex fails before any network call
    }

    public function testPlatformWithoutExtensionCannotCheck(): void {
        // The xcvm_core extension is not loaded in the test runtime: the store's
        // catalogue cannot be read, which is an error, not "nothing newer".
        $result = $this->checker->latestAvailable([
            'update'            => ['source' => 'platform'],
            'hash_id'           => str_repeat('ab', 16),
            'installed_version' => '1.0.0',
        ]);
        $this->assertNull($result);
        $this->assertStringContainsString('no_extension', (string) $this->checker->lastError());
    }

    /** A store module's latest version comes from the catalogue, by hash_id (or an older store's slug), read once for every module. */
    public function testPlatformReadsTheCatalogueOnceByHashId(): void {
        $checker = $this->storeChecker([
            1 => ['ok' => true, 'last_page' => 2, 'extensions' => [['hash_id' => str_repeat('a1', 16), 'slug' => 'watchfolder-sdfis', 'version' => '1.2.0']]],
            2 => ['ok' => true, 'last_page' => 2, 'extensions' => [['slug' => 'plex', 'version' => '2.1.0']]],
        ]);
        $this->assertSame('1.2.0', $checker->latestAvailable(['update' => ['source' => 'platform'], 'hash_id' => str_repeat('a1', 16), 'name' => 'watchfolder']));
        $this->assertSame('2.1.0', $checker->latestAvailable(['update' => ['source' => 'platform'], 'name' => 'plex']), 'an older store: its slug');
        $this->assertNull($checker->latestAvailable(['update' => ['source' => 'platform'], 'hash_id' => str_repeat('ff', 16)]), 'not listed: nothing newer');
        $this->assertNull($checker->lastError());
        $this->assertSame([1, 2], $checker->pages, 'every page, once');
    }

    /** A store that does not answer is an error for every module of the check, so none loses the flag it had. */
    public function testAStoreThatDoesNotAnswerFailsEveryModule(): void {
        $checker = $this->storeChecker([1 => ['ok' => false, 'reason' => 'timeout']]);
        foreach ([str_repeat('a1', 16), str_repeat('b2', 16)] as $hash) {
            $this->assertNull($checker->latestAvailable(['update' => ['source' => 'platform'], 'hash_id' => $hash]));
            $this->assertSame('store catalogue: timeout', $checker->lastError());
        }
    }

    /** A checker whose catalogue pages are canned; $pages records the pages read. */
    private function storeChecker(array $answers): ModuleUpdateChecker {
        return new class($answers) extends ModuleUpdateChecker {
            public array $pages = array();

            public function __construct(private array $answers) {
            }

            protected function cataloguePage(string $rKey, int $rPage): array {
                $this->pages[] = $rPage;
                return $this->answers[$rPage] ?? ['ok' => false, 'reason' => 'no page'];
            }
        };
    }

    /**
     * A checker whose release list and manifest fetches are canned: $tags newest
     * first, $manifests tag => module.json body ('' = unreadable).
     */
    private function gitChecker(array $tags, array $manifests): ModuleUpdateChecker {
        return new class($tags, $manifests) extends ModuleUpdateChecker {
            public array $fetched = array();

            public function __construct(private array $tags, private array $manifests) {
            }

            protected function releaseTags(string $owner, string $repo, string $channel): array {
                return $this->tags;
            }

            protected function httpGet(string $url): string {
                $this->fetched[] = $url;
                $tag = basename(dirname($url));
                return $this->manifests[$tag] ?? '';
            }
        };
    }

    private function gitModule(string $installed): array {
        return array('update' => array('source' => 'git', 'repository' => 'https://github.com/Vateron-Media/Module_Test'), 'installed_version' => $installed);
    }

    public function testGitOffersTheNewestReleaseThisCoreCanRun(): void {
        $checker = $this->gitChecker(array('1.3.0', '1.2.0', '1.1.0', '1.0.0'), array(
            '1.3.0' => json_encode(array('requires_core' => '>=99.0')),
            '1.2.0' => json_encode(array('requires_core' => '>=2.0')),
        ));

        $this->assertSame('1.2.0', $checker->latestAvailable($this->gitModule('1.0.0')));
        $this->assertNull($checker->lastError());
        $this->assertSame('https://raw.githubusercontent.com/Vateron-Media/Module_Test/1.3.0/module.json', $checker->fetched[0]);
    }

    public function testGitOffersNothingWhenNoNewerReleaseFitsThisCore(): void {
        $checker = $this->gitChecker(array('1.2.0', '1.1.0', '1.0.0'), array(
            '1.2.0' => json_encode(array('requires_core' => '>=99.0')),
            '1.1.0' => json_encode(array('requires_core' => '>=98.0')),
        ));

        $this->assertNull($checker->latestAvailable($this->gitModule('1.0.0')));
        $this->assertNull($checker->lastError(), 'not an error: nothing to offer');
        $this->assertCount(2, $checker->fetched, 'the installed release is not checked');
    }

    public function testGitOffersAReleaseWhoseManifestCannotBeRead(): void {
        $checker = $this->gitChecker(array('1.1.0', '1.0.0'), array());

        $this->assertSame('1.1.0', $checker->latestAvailable($this->gitModule('1.0.0')));
    }

    public function testUrlOffersAVersionOnlyWhenThisCoreCanRunIt(): void {
        $module = array('update' => array('source' => 'url', 'url' => 'https://example.test/version.json'));

        $fits = $this->gitChecker(array(), array('example.test' => json_encode(array('version' => '1.2.0', 'requires_core' => '>=2.0'))));
        $this->assertSame('1.2.0', $fits->latestAvailable($module));

        $ahead = $this->gitChecker(array(), array('example.test' => json_encode(array('version' => '1.2.0', 'requires_core' => '>=99.0'))));
        $this->assertNull($ahead->latestAvailable($module));
        $this->assertNull($ahead->lastError(), 'not an error: nothing to offer');
    }
}