first commit

vendor/spatie/laravel-ignition/src/Commands/SolutionMakeCommand.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Spatie\LaravelIgnition\Commands;
+
+use Illuminate\Console\GeneratorCommand;
+use Symfony\Component\Console\Input\InputOption;
+
+class SolutionMakeCommand extends GeneratorCommand
+{
+    protected $name = 'ignition:make-solution';
+
+    protected $description = 'Create a new custom Ignition solution class';
+
+    protected $type = 'Solution';
+
+    protected function getStub(): string
+    {
+        return $this->option('runnable')
+            ? __DIR__.'/stubs/runnable-solution.stub'
+            : __DIR__.'/stubs/solution.stub';
+    }
+
+    protected function getDefaultNamespace($rootNamespace)
+    {
+        return "{$rootNamespace}\\Solutions";
+    }
+
+    /** @return array<int, mixed> */
+    protected function getOptions(): array
+    {
+        return [
+            ['runnable', null, InputOption::VALUE_NONE, 'Create runnable solution'],
+        ];
+    }
+}

vendor/spatie/laravel-ignition/src/Commands/SolutionProviderMakeCommand.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Spatie\LaravelIgnition\Commands;
+
+use Illuminate\Console\GeneratorCommand;
+
+class SolutionProviderMakeCommand extends GeneratorCommand
+{
+    protected $name = 'ignition:make-solution-provider';
+
+    protected $description = 'Create a new custom Ignition solution provider class';
+
+    protected $type = 'Solution Provider';
+
+    protected function getStub(): string
+    {
+        return __DIR__.'/stubs/solution-provider.stub';
+    }
+
+    protected function getDefaultNamespace($rootNamespace)
+    {
+        return "{$rootNamespace}\\SolutionProviders";
+    }
+}

vendor/spatie/laravel-ignition/src/Commands/TestCommand.php

@@ -0,0 +1,131 @@
+<?php
+
+namespace Spatie\LaravelIgnition\Commands;
+
+use Composer\InstalledVersions;
+use Exception;
+use Illuminate\Config\Repository;
+use Illuminate\Console\Command;
+use Illuminate\Log\LogManager;
+use Spatie\FlareClient\Flare;
+use Spatie\FlareClient\Http\Exceptions\BadResponseCode;
+
+class TestCommand extends Command
+{
+    protected $signature = 'flare:test';
+
+    protected $description = 'Send a test notification to Flare';
+
+    protected Repository $config;
+
+    public function handle(Repository $config): void
+    {
+        $this->config = $config;
+
+        $this->checkFlareKey();
+
+        if (app()->make('log') instanceof LogManager) {
+            $this->checkFlareLogger();
+        }
+
+        $this->sendTestException();
+    }
+
+    protected function checkFlareKey(): self
+    {
+        $message = empty($this->config->get('flare.key'))
+            ? '❌ Flare key not specified. Make sure you specify a value in the `key` key of the `flare` config file.'
+            : '✅ Flare key specified';
+
+        $this->info($message);
+
+        return $this;
+    }
+
+    public function checkFlareLogger(): self
+    {
+        $defaultLogChannel = $this->config->get('logging.default');
+
+        $activeStack = $this->config->get("logging.channels.{$defaultLogChannel}");
+
+        if (is_null($activeStack)) {
+            $this->info("❌ The default logging channel `{$defaultLogChannel}` is not configured in the `logging` config file");
+        }
+
+        if (! isset($activeStack['channels']) || ! in_array('flare', $activeStack['channels'])) {
+            $this->info("❌ The logging channel `{$defaultLogChannel}` does not contain the 'flare' channel");
+        }
+
+        if (is_null($this->config->get('logging.channels.flare'))) {
+            $this->info('❌ There is no logging channel named `flare` in the `logging` config file');
+        }
+
+        if ($this->config->get('logging.channels.flare.driver') !== 'flare') {
+            $this->info('❌ The `flare` logging channel defined in the `logging` config file is not set to `flare`.');
+        }
+
+        if ($this->config->get('ignition.with_stack_frame_arguments') && ini_get('zend.exception_ignore_args')) {
+            $this->info('⚠️ The `zend.exception_ignore_args` php ini setting is enabled. This will prevent Flare from showing stack trace arguments.');
+        }
+
+        $this->info('✅ The Flare logging driver was configured correctly.');
+
+        return $this;
+    }
+
+    protected function sendTestException(): void
+    {
+        $testException = new Exception('This is an exception to test if the integration with Flare works.');
+
+        try {
+            app(Flare::class)->sendTestReport($testException);
+            $this->info('');
+        } catch (Exception $exception) {
+            $this->warn('❌ We were unable to send an exception to Flare. ');
+
+            if ($exception instanceof BadResponseCode) {
+                $this->info('');
+                $message = 'Unknown error';
+
+                $body = $exception->response->getBody();
+
+                if (is_array($body) && isset($body['message'])) {
+                    $message = $body['message'];
+                }
+
+                $this->warn("{$exception->response->getHttpResponseCode()} - {$message}");
+            } else {
+                $this->warn($exception->getMessage());
+            }
+
+            $this->warn('Make sure that your key is correct and that you have a valid subscription.');
+            $this->info('');
+            $this->info('For more info visit the docs on https://flareapp.io/docs/ignition-for-laravel/introduction');
+            $this->info('You can see the status page of Flare at https://status.flareapp.io');
+            $this->info('Flare support can be reached at support@flareapp.io');
+
+            $this->line('');
+            $this->line('Extra info');
+            $this->table([], [
+                ['Platform', PHP_OS],
+                ['PHP', phpversion()],
+                ['Laravel', app()->version()],
+                ['spatie/ignition', InstalledVersions::getVersion('spatie/ignition')],
+                ['spatie/laravel-ignition', InstalledVersions::getVersion('spatie/laravel-ignition')],
+                ['spatie/flare-client-php', InstalledVersions::getVersion('spatie/flare-client-php')],
+                /** @phpstan-ignore-next-line */
+                ['Curl', curl_version()['version'] ?? 'Unknown'],
+                /** @phpstan-ignore-next-line */
+                ['SSL', curl_version()['ssl_version'] ?? 'Unknown'],
+            ]);
+
+            if ($this->output->isVerbose()) {
+                throw $exception;
+            }
+
+            return;
+        }
+
+        $this->info('We tried to send an exception to Flare. Please check if it arrived!');
+    }
+}

vendor/spatie/laravel-ignition/src/Commands/stubs/runnable-solution.stub

@@ -0,0 +1,43 @@
+<?php
+
+namespace DummyNamespace;
+
+use Spatie\Ignition\Contracts\RunnableSolution;
+
+class DummyClass implements RunnableSolution
+{
+    public function getSolutionTitle(): string
+    {
+        return '';
+    }
+
+    public function getDocumentationLinks(): array
+    {
+        return [];
+    }
+
+    public function getSolutionActionDescription(): string
+    {
+        return '';
+    }
+
+    public function getRunButtonText(): string
+    {
+        return '';
+    }
+
+    public function getSolutionDescription(): string
+    {
+        return '';
+    }
+
+    public function getRunParameters(): array
+    {
+        return [];
+    }
+
+    public function run(array $parameters = [])
+    {
+        //
+    }
+}

vendor/spatie/laravel-ignition/src/Commands/stubs/solution-provider.stub

@@ -0,0 +1,19 @@
+<?php
+
+namespace DummyNamespace;
+
+use Spatie\Ignition\Contracts\HasSolutionsForThrowable;
+use Throwable;
+
+class DummyClass implements HasSolutionsForThrowable
+{
+    public function canSolve(Throwable $throwable): bool
+    {
+        return false;
+    }
+
+    public function getSolutions(Throwable $throwable): array
+    {
+        return [];
+    }
+}

vendor/spatie/laravel-ignition/src/Commands/stubs/solution.stub

@@ -0,0 +1,23 @@
+<?php
+
+namespace DummyNamespace;
+
+use Spatie\Ignition\Contracts\Solution;
+
+class DummyClass implements Solution
+{
+    public function getSolutionTitle(): string
+    {
+        return '';
+    }
+
+    public function getSolutionDescription(): string
+    {
+        return '';
+    }
+
+    public function getDocumentationLinks(): array
+    {
+        return [];
+    }
+}