create-nevela 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nevela",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Create a new Nevela app: a Laravel API and a Next.js dashboard from one resource description.",
   "type": "module",
   "bin": {

package/packagist.mjs

@@ -1,25 +1,34 @@
-// Deciding where a new app gets nevela/laravel from.
-
-/** Whether `candidate` is a stable release Composer's `^major.minor` would accept. */
-export function satisfiesCaret(candidate, [major, minor]) {
-  const match = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(candidate);
-  if (!match) return false;
-  const [theirMajor, theirMinor] = match.slice(1).map(Number);
-  // Below 1.0 a caret holds the minor version too: ^0.1 means 0.1.x only.
-  return major === 0 ? theirMajor === 0 && theirMinor === minor : theirMajor === major && theirMinor >= minor;
-}
-
-/**
- * Whether Packagist has a release of nevela/laravel that goes with this installer. Being
- * listed isn't enough: with no tagged release yet, `composer require` would fail.
- */
-export async function onPackagist(wanted) {
-  try {
-    const response = await fetch('https://repo.packagist.org/p2/nevela/laravel.json', { signal: AbortSignal.timeout(8000) });
-    if (!response.ok) return false;
-    const releases = (await response.json()).packages?.['nevela/laravel'] ?? [];
-    return releases.some((release) => satisfiesCaret(release.version, wanted));
-  } catch {
-    return false;
-  }
-}
+// Deciding where a new app gets nevela/laravel from.
+
+/** Whether `candidate` is a stable release Composer's `^major.minor` would accept. */
+export function satisfiesCaret(candidate, [major, minor]) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(candidate);
+  if (!match) return false;
+  const [theirMajor, theirMinor] = match.slice(1).map(Number);
+  // Below 1.0 a caret holds the minor version too: ^0.1 means 0.1.x only.
+  return major === 0 ? theirMajor === 0 && theirMinor === minor : theirMajor === major && theirMinor >= minor;
+}
+
+/** Whether stable version `a` is newer than `b`. Anything that isn't x.y.z is never newer. */
+export function isNewer(a, b) {
+  const parse = (version) => /^(\d+)\.(\d+)\.(\d+)$/.exec(String(version))?.slice(1).map(Number);
+  const [left, right] = [parse(a), parse(b)];
+  if (!left || !right) return false;
+  for (let i = 0; i < 3; i++) if (left[i] !== right[i]) return left[i] > right[i];
+  return false;
+}
+
+/**
+ * Whether Packagist has a release of nevela/laravel that goes with this installer. Being
+ * listed isn't enough: with no tagged release yet, `composer require` would fail.
+ */
+export async function onPackagist(wanted) {
+  try {
+    const response = await fetch('https://repo.packagist.org/p2/nevela/laravel.json', { signal: AbortSignal.timeout(8000) });
+    if (!response.ok) return false;
+    const releases = (await response.json()).packages?.['nevela/laravel'] ?? [];
+    return releases.some((release) => satisfiesCaret(release.version, wanted));
+  } catch {
+    return false;
+  }
+}

package/template/laravel/README.md

@@ -43,6 +43,7 @@ Needs PHP 8.2 or newer and Laravel 11, 12 or 13.
 | `nevela:generate` | Regenerate after changing a descriptor. Your own code is kept. |
 | `nevela:seed` | Fill a resource with plausible records, and print how long it took. |
 | `nevela:user` | Create someone who can sign in. |
+| `nevela:update` | Update the package, the generated code and the dashboard. |
 
 Full documentation: https://nevela-docs.vercel.app
 

package/template/laravel/config/nevela.php

@@ -13,6 +13,13 @@ return [
     */
     'web_path' => env('NEVELA_WEB_PATH', base_path('../web')),
 
+    /*
+    | The top of the project, where the `php nevela` launcher is written. Null works it
+    | out: two folders up when this app is at <project>/apps/<name>. Set a path if yours
+    | is somewhere else, or false to have no launcher.
+    */
+    'root_path' => env('NEVELA_ROOT_PATH'),
+
     /* URL prefix and middleware for generated resource routes (routes/nevela.php). */
     'prefix' => 'api',
     'middleware' => ['api', 'auth:sanctum'],

package/template/laravel/src/Console/DevCommand.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace Nevela\Laravel\Console;
+
+use Illuminate\Console\Command;
+use Symfony\Component\Process\PhpExecutableFinder;
+use Symfony\Component\Process\Process;
+
+final class DevCommand extends Command
+{
+    protected $signature = 'nevela:dev
+        {--port=8000 : The first port to try for the API}
+        {--api-only : Start the API without the dashboard}';
+
+    protected $description = 'Run the API and the dashboard together';
+
+    public function handle(): int
+    {
+        $wanted = max(1, (int) $this->option('port'));
+        $port = self::freePort($wanted);
+        if ($port === null) {
+            $this->components->error("Ports {$wanted} to ".($wanted + 19).' are all in use. Free one, or pass --port.');
+
+            return self::FAILURE;
+        }
+        if ($port !== $wanted) {
+            // Without this check the dashboard would talk to whatever already owns the port.
+            // On Windows two servers can listen on the same one, and the older one answers.
+            $this->components->warn("Port {$wanted} is already in use by another program, so the API is on {$port}.");
+        }
+        $url = "http://127.0.0.1:{$port}";
+
+        $php = (new PhpExecutableFinder)->find(false) ?: 'php';
+        $api = new Process([$php, 'artisan', 'serve', '--host=127.0.0.1', "--port={$port}"], base_path(), null, null, null);
+
+        $web = null;
+        $webPath = config('nevela.web_path');
+        if (! $this->option('api-only') && $webPath && is_dir($webPath)) {
+            // The dashboard is told where the API really is, whatever its .env.local says.
+            $web = Process::fromShellCommandline(self::packageManager($webPath).' run dev', $webPath, ['NEVELA_API_URL' => "{$url}/api"], null, null);
+        }
+
+        $this->components->info('Starting '.($web ? 'the API and the dashboard' : 'the API').'. Press Ctrl+C to stop.');
+        $this->components->twoColumnDetail('API', $url);
+        if ($web) {
+            $this->components->twoColumnDetail('Dashboard', 'http://localhost:3000/sign-in (see below if that port is taken)');
+        }
+        $this->newLine();
+
+        $api->start($this->printer('api', 35));
+        $web?->start($this->printer('web', 36));
+
+        try {
+            while ($api->isRunning() && ($web === null || $web->isRunning())) {
+                usleep(200_000);
+            }
+        } finally {
+            // Whichever stopped, or Ctrl+C: don't leave the other one running behind.
+            $web?->stop(3);
+            $api->stop(3);
+        }
+
+        return self::SUCCESS;
+    }
+
+    /** The first port from `$from` that nothing is listening on, or null if twenty in a row are taken. */
+    public static function freePort(int $from): ?int
+    {
+        for ($port = $from; $port < $from + 20; $port++) {
+            $socket = @fsockopen('127.0.0.1', $port, $code, $message, 0.3);
+            if ($socket === false) {
+                return $port;
+            }
+            fclose($socket);
+        }
+
+        return null;
+    }
+
+    /** The package manager a folder was installed with, from its lock file. */
+    public static function packageManager(string $dir): string
+    {
+        return match (true) {
+            is_file("{$dir}/pnpm-lock.yaml"), is_file("{$dir}/pnpm-workspace.yaml") => 'pnpm',
+            is_file("{$dir}/yarn.lock") => 'yarn',
+            is_file("{$dir}/bun.lockb"), is_file("{$dir}/bun.lock") => 'bun',
+            default => 'npm',
+        };
+    }
+
+    /** Prints a process's output a line at a time, each line labelled with which app it came from. */
+    private function printer(string $name, int $colour): \Closure
+    {
+        $rest = '';
+
+        return function (string $type, string $chunk) use ($name, $colour, &$rest) {
+            $lines = explode("\n", $rest.str_replace("\r\n", "\n", $chunk));
+            $rest = array_pop($lines);
+            foreach ($lines as $line) {
+                $this->output->writeln("\e[{$colour}m{$name}\e[0m │ ".$line, \Symfony\Component\Console\Output\OutputInterface::OUTPUT_RAW);
+            }
+        };
+    }
+}

package/template/laravel/src/Console/GenerateCommand.php

@@ -1,77 +1,107 @@
-<?php
-
-namespace Nevela\Laravel\Console;
-
-use Illuminate\Console\Command;
-use InvalidArgumentException;
-use Nevela\Laravel\Generator\ResourceGenerator;
-use Nevela\Laravel\Generator\Writer;
-use Nevela\Laravel\Nevela;
-use Nevela\Laravel\Support\Descriptor;
-
-final class GenerateCommand extends Command
-{
-    protected $signature = 'nevela:generate
-        {name? : Only this resource (e.g. Product). Default: every descriptor}
-        {--force : Rewrite generated blocks even where you edited inside them}';
-
-    protected $description = 'Regenerate Laravel code and Flare descriptors from nevela/resources/*.json';
-
-    public function handle(): int
-    {
-        Nevela::forget();
-        try {
-            $all = Nevela::all();
-            $targets = $this->argument('name') ? [Nevela::resource($this->argument('name'))] : $all;
-        } catch (InvalidArgumentException $e) {
-            $this->components->error($e->getMessage());
-
-            return self::FAILURE;
-        }
-        // With no descriptors there is still an (empty) route file and web registry to
-        // write, so a new app's dashboard builds before its first resource exists.
-        $status = self::generate($this, $targets, $all, (bool) $this->option('force'));
-        if ($all === []) {
-            $this->components->warn('No descriptors yet. Start with: php artisan nevela:resource Product --fields="name:string, price:money"');
-        }
-
-        return $status;
-    }
-
-    /** @param list<Descriptor> $targets @param list<Descriptor> $all */
-    public static function generate(Command $command, array $targets, array $all, bool $force): int
-    {
-        $generator = new ResourceGenerator;
-        $files = [];
-        foreach ($targets as $descriptor) {
-            array_push($files, ...$generator->forResource($descriptor));
-        }
-        $files[] = $generator->routes($all);
-        $files[] = $generator->registry($all);
-
-        $roots = ['api' => base_path()];
-        if (($web = config('nevela.web_path')) && is_dir($web)) {
-            $roots['web'] = $web;
-        }
-
-        $report = (new Writer($roots, $force))->write($files);
-        $edited = 0;
-        foreach ($report as $row) {
-            $path = str_replace([base_path().DIRECTORY_SEPARATOR, '\\'], ['', '/'], $row['path']);
-            $command->components->twoColumnDetail($path, match ($row['status']) {
-                'created' => '<fg=green>created</>',
-                'updated' => '<fg=blue>updated</>',
-                'edited' => '<fg=yellow>skipped — edited inside generated block</>',
-                'exists' => '<fg=gray>exists (yours)</>',
-                'skipped' => '<fg=gray>skipped (no web app at nevela.web_path yet)</>',
-                default => '<fg=gray>unchanged</>',
-            });
-            $edited += $row['status'] === 'edited' ? 1 : 0;
-        }
-        if ($edited) {
-            $command->components->warn("{$edited} file(s) skipped because you edited their generated block. Move your changes outside it, or rerun with --force.");
-        }
-
-        return self::SUCCESS;
-    }
-}
+<?php
+
+namespace Nevela\Laravel\Console;
+
+use Illuminate\Console\Command;
+use InvalidArgumentException;
+use Nevela\Laravel\Generator\ResourceGenerator;
+use Nevela\Laravel\Generator\Writer;
+use Nevela\Laravel\Nevela;
+use Nevela\Laravel\Support\Descriptor;
+
+final class GenerateCommand extends Command
+{
+    protected $signature = 'nevela:generate
+        {name? : Only this resource (e.g. Product). Default: every descriptor}
+        {--force : Rewrite generated blocks even where you edited inside them}';
+
+    protected $description = 'Regenerate Laravel code and Flare descriptors from nevela/resources/*.json';
+
+    public function handle(): int
+    {
+        Nevela::forget();
+        try {
+            $all = Nevela::all();
+            $targets = $this->argument('name') ? [Nevela::resource($this->argument('name'))] : $all;
+        } catch (InvalidArgumentException $e) {
+            $this->components->error($e->getMessage());
+
+            return self::FAILURE;
+        }
+        // With no descriptors there is still an (empty) route file and web registry to
+        // write, so a new app's dashboard builds before its first resource exists.
+        $status = self::generate($this, $targets, $all, (bool) $this->option('force'));
+        if ($all === []) {
+            $this->components->warn('No descriptors yet. Start with: php artisan nevela:resource Product --fields="name:string, price:money"');
+        }
+
+        return $status;
+    }
+
+    /**
+     * The top of the project, where `php nevela` lives: nevela.root_path if set, otherwise
+     * two levels up when the app sits in <project>/apps/<name>. Null for a Laravel app that
+     * isn't inside such a project, which gets no launcher.
+     */
+    public static function projectRoot(): ?string
+    {
+        $configured = config('nevela.root_path');
+        if ($configured === false) {
+            return null;
+        }
+        if (is_string($configured) && $configured !== '') {
+            return is_dir($configured) ? rtrim((string) realpath($configured), '/\\') : null;
+        }
+        $base = base_path();
+
+        return basename(dirname($base)) === 'apps' ? dirname($base, 2) : null;
+    }
+
+    /** @param list<Descriptor> $targets @param list<Descriptor> $all */
+    public static function generate(Command $command, array $targets, array $all, bool $force): int
+    {
+        $generator = new ResourceGenerator;
+        $files = [];
+        foreach ($targets as $descriptor) {
+            array_push($files, ...$generator->forResource($descriptor));
+        }
+        $files[] = $generator->routes($all);
+        $files[] = $generator->registry($all);
+
+        $roots = ['api' => base_path()];
+        if (($web = config('nevela.web_path')) && is_dir($web)) {
+            $roots['web'] = $web;
+        }
+        if ($root = self::projectRoot()) {
+            $roots['root'] = $root;
+            $apiFromRoot = ltrim(str_replace('\\', '/', substr(base_path(), strlen($root))), '/');
+            $files[] = $generator->launcher($apiFromRoot);
+        }
+
+        $report = (new Writer($roots, $force))->write($files);
+        $edited = 0;
+        // Shown relative to the Laravel app, like the dashboard's files: ../../nevela
+        $rootShown = isset($apiFromRoot) ? rtrim(str_repeat('../', substr_count($apiFromRoot, '/') + 1), '/') : '';
+        foreach ($report as $row) {
+            $path = $row['path'];
+            if (isset($roots['root']) && str_starts_with($path, $roots['root'].DIRECTORY_SEPARATOR) && ! str_starts_with($path, base_path().DIRECTORY_SEPARATOR)) {
+                $path = $rootShown.substr($path, strlen($roots['root']));
+            }
+            $path = str_replace([base_path().DIRECTORY_SEPARATOR, '\\'], ['', '/'], $path);
+            $command->components->twoColumnDetail($path, match ($row['status']) {
+                'created' => '<fg=green>created</>',
+                'updated' => '<fg=blue>updated</>',
+                'edited' => '<fg=yellow>skipped — edited inside generated block</>',
+                'exists' => '<fg=gray>exists (yours)</>',
+                'skipped' => '<fg=gray>skipped (no web app at nevela.web_path yet)</>',
+                default => '<fg=gray>unchanged</>',
+            });
+            $edited += $row['status'] === 'edited' ? 1 : 0;
+        }
+        if ($edited) {
+            $command->components->warn("{$edited} file(s) skipped because you edited their generated block. Move your changes outside it, or rerun with --force.");
+        }
+
+        return self::SUCCESS;
+    }
+}

package/template/laravel/src/Console/MakeResourceCommand.php

@@ -15,7 +15,9 @@ final class MakeResourceCommand extends Command
         {--fields= : "name:string, sku:string!, price:money, status:enum(draft|live), notes:text?"}
         {--icon= : Lucide icon name for the dashboard, e.g. package}
         {--group= : Sidebar group in the dashboard}
-        {--force : Overwrite an existing descriptor}';
+        {--force : Overwrite an existing descriptor}
+        {--migrate : Run the new migration straight away}
+        {--seed= : Fill the new resource with records too (25, or the number you give). Runs the migration first}';
 
     protected $description = 'Describe a resource once, then generate its Laravel API and Flare dashboard descriptor';
 
@@ -50,8 +52,21 @@ final class MakeResourceCommand extends Command
         Nevela::forget();
         $status = GenerateCommand::generate($this, [$descriptor], Nevela::all(), false);
 
+        // "--seed" on its own and "--seed=100" both count; without a number it is 25.
+        $seed = $this->input->hasParameterOption('--seed') || $this->option('seed') !== null;
+        $migrate = $this->option('migrate') || $seed;
+
+        if ($status === self::SUCCESS && $migrate) {
+            $status = $this->call('migrate');
+        }
+        if ($status === self::SUCCESS && $seed) {
+            $status = $this->call('nevela:seed', ['name' => $descriptor->name, '--count' => $this->option('seed') ?: 25]);
+        }
+
         $this->newLine();
-        $this->line('  Next: <fg=cyan>php artisan migrate</>, then tighten <fg=cyan>app/Policies/'.$descriptor->name.'Policy.php</>.');
+        $this->line($migrate
+            ? '  Next: tighten <fg=cyan>app/Policies/'.$descriptor->name.'Policy.php</>.'
+            : '  Next: <fg=cyan>php artisan migrate</>, then tighten <fg=cyan>app/Policies/'.$descriptor->name.'Policy.php</>.');
         $this->line("  API:  GET|POST /{$this->prefix()}{$descriptor->slug} · GET|PUT|PATCH|DELETE /{$this->prefix()}{$descriptor->slug}/{id} · GET /{$this->prefix()}{$descriptor->slug}/_stats");
 
         return $status;

package/template/laravel/src/Console/StatusCommand.php

@@ -0,0 +1,172 @@
+<?php
+
+namespace Nevela\Laravel\Console;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Http;
+use Nevela\Laravel\Nevela;
+use Nevela\Laravel\Support\Releases;
+use Throwable;
+
+final class StatusCommand extends Command
+{
+    protected $signature = 'nevela:status';
+
+    protected $description = 'Check the app: versions, the database, migrations, users, resources and the dashboard';
+
+    public function handle(): int
+    {
+        $problems = 0;
+        $row = fn (string $label, string $value) => $this->components->twoColumnDetail($label, $value);
+        $bad = function (string $text) use (&$problems): string {
+            $problems++;
+
+            return "<fg=red>{$text}</>";
+        };
+
+        $this->newLine();
+        $latest = Releases::latest();
+        $row('Nevela', Nevela::VERSION.match (true) {
+            $latest === null => ' <fg=gray>(couldn\'t check for a newer one)</>',
+            version_compare($latest, Nevela::VERSION, '>') => " <fg=yellow>({$latest} is out: php nevela update)</>",
+            default => ' <fg=green>(latest)</>',
+        });
+        $row('Laravel / PHP', app()->version().' / '.PHP_VERSION);
+
+        // --- database ---
+        try {
+            $connection = DB::connection();
+            $connection->getPdo();
+            $name = $connection->getDatabaseName();
+            $row('Database', $connection->getDriverName().($name ? ' · '.str_replace(base_path().DIRECTORY_SEPARATOR, '', (string) $name) : ''));
+
+            $migrator = app('migrator');
+            if (! $migrator->repositoryExists()) {
+                $row('Migrations', $bad('none have run: php nevela migrate'));
+            } else {
+                $ran = $migrator->getRepository()->getRan();
+                $files = array_keys($migrator->getMigrationFiles([...$migrator->paths(), database_path('migrations')]));
+                $pending = array_values(array_diff($files, $ran));
+                $row('Migrations', count($ran).' ran, '.($pending === []
+                    ? '<fg=green>none pending</>'
+                    : $bad(count($pending).' pending: php nevela migrate')));
+                foreach ($pending as $migration) {
+                    $this->line("    <fg=gray>pending</> {$migration}");
+                }
+            }
+
+            $model = config('auth.providers.users.model');
+            if (is_string($model) && class_exists($model)) {
+                try {
+                    $users = $model::query()->count();
+                    $row('Users who can sign in', $users > 0 ? (string) $users : $bad('none: php nevela user'));
+                } catch (Throwable) {
+                    $row('Users who can sign in', $bad('the users table is missing: php nevela migrate'));
+                }
+            }
+        } catch (Throwable $e) {
+            $row('Database', $bad('can\'t connect: '.str($e->getMessage())->limit(90)));
+        }
+
+        // --- resources ---
+        try {
+            $resources = Nevela::all();
+        } catch (Throwable $e) {
+            $resources = [];
+            $row('Resources', $bad('a descriptor can\'t be read: '.str($e->getMessage())->limit(90)));
+        }
+        if ($resources === []) {
+            $row('Resources', '<fg=gray>none yet: php nevela resource Product --fields="name:string"</>');
+        }
+        foreach ($resources as $resource) {
+            try {
+                $row("Resource: {$resource->name}", number_format(DB::table($resource->table)->count()).' records');
+            } catch (Throwable) {
+                $row("Resource: {$resource->name}", $bad("the {$resource->table} table is missing: php nevela migrate"));
+            }
+        }
+
+        // --- dashboard ---
+        $web = config('nevela.web_path');
+        if (! $web || ! is_dir($web)) {
+            $row('Dashboard', '<fg=gray>not found at nevela.web_path</>');
+        } else {
+            $marker = json_decode((string) @file_get_contents(rtrim($web, '/\\').'/.nevela.json'), true);
+            $row('Dashboard', is_array($marker) && isset($marker['template']) ? "template {$marker['template']}" : '<fg=gray>template version not recorded</>');
+
+            // `php nevela dev` may have put the API on another port and told the dashboard so,
+            // which is fine. Look for this app wherever it is running before judging.
+            $url = self::apiUrl($web);
+            $who = self::whoAnswers($url);
+            $running = $who === 'this' ? $url : self::findRunning();
+
+            if ($who === 'this') {
+                $row('API', "{$url} <fg=green>(running, and it is this app)</>");
+            } elseif ($running !== null) {
+                $row('API', "{$running} <fg=green>(running, and it is this app)</>");
+                $row('', '<fg=gray>'.parse_url($url, PHP_URL_PORT).' belongs to another program; php nevela dev chose a free port</>');
+            } elseif ($who === 'nobody') {
+                $row('API', '<fg=gray>not running: php nevela dev</>');
+            } else {
+                $row('API', $bad("{$url} is answered by ".($who === 'nevela' ? 'another Nevela app' : 'another program').', not this app'));
+                $row('', '<fg=gray>start with php nevela dev, which picks a free port and tells the dashboard</>');
+            }
+        }
+        $this->newLine();
+
+        if ($problems > 0) {
+            $this->components->warn($problems === 1 ? 'One thing needs attention, marked in red above.' : "{$problems} things need attention, marked in red above.");
+
+            return self::FAILURE;
+        }
+        $this->components->info('Everything looks right.');
+
+        return self::SUCCESS;
+    }
+
+    /** Where the dashboard is told the API is: NEVELA_API_URL in its .env.local, else the default. */
+    public static function apiUrl(string $web): string
+    {
+        $env = (string) @file_get_contents(rtrim($web, '/\\').'/.env.local');
+        if (preg_match('/^\s*NEVELA_API_URL\s*=\s*["\']?([^"\'\r\n#]+)/m', $env, $m)) {
+            return rtrim(trim($m[1]), '/');
+        }
+
+        return 'http://127.0.0.1:8000/api';
+    }
+
+    /** Who answers at an API address: 'this' app, another 'nevela' app, some 'other' program, or 'nobody'. */
+    public static function whoAnswers(string $url): string
+    {
+        try {
+            $response = Http::timeout(3)->acceptJson()->get($url.'/_nevela/ping');
+        } catch (Throwable) {
+            return 'nobody';
+        }
+        if ($response->json('app') === Nevela::fingerprint()) {
+            return 'this';
+        }
+
+        return $response->json('nevela') !== null ? 'nevela' : 'other';
+    }
+
+    /** This app's API on one of the ports `php nevela dev` would use, or null if it isn't running. */
+    private static function findRunning(): ?string
+    {
+        $prefix = trim((string) config('nevela.prefix', 'api'), '/');
+        for ($port = 8000; $port < 8020; $port++) {
+            $socket = @fsockopen('127.0.0.1', $port, $code, $message, 0.15);
+            if ($socket === false) {
+                continue;
+            }
+            fclose($socket);
+            $url = "http://127.0.0.1:{$port}".($prefix === '' ? '' : "/{$prefix}");
+            if (self::whoAnswers($url) === 'this') {
+                return $url;
+            }
+        }
+
+        return null;
+    }
+}