feat: add Laravel service provider for zero-config setup

composer.json

@@ -43,6 +43,13 @@
             "pestphp/pest-plugin": true
         }
     },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "ConduitUI\\Pr\\PrServiceProvider"
+            ]
+        }
+    },
     "minimum-stability": "dev",
     "prefer-stable": true
 }

config/pr.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | GitHub Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configure your GitHub access token for pull request operations.
+    | You can set this in your .env file as GITHUB_TOKEN or configure
+    | it in config/services.php under 'github.token'.
+    |
+    */
+
+    'github' => [
+        'token' => env('GITHUB_TOKEN'),
+    ],
+];

phpstan.neon

@@ -2,6 +2,10 @@ parameters:
     level: 8
     paths:
         - src
+    excludePaths:
+        # Excluded because it depends on Laravel's ServiceProvider which isn't available
+        # in the non-Laravel test environment. The class is only used in Laravel apps.
+        - src/PrServiceProvider.php
     tmpDir: build/phpstan
     ignoreErrors:
         -

src/PrServiceProvider.php

@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ConduitUI\Pr;
+
+use ConduitUi\GitHubConnector\Connector;
+use ConduitUI\Pr\Contracts\PrServiceInterface;
+use ConduitUI\Pr\Services\GitHubPrService;
+use Illuminate\Support\ServiceProvider;
+
+class PrServiceProvider extends ServiceProvider
+{
+    /**
+     * Register services.
+     */
+    public function register(): void
+    {
+        $this->mergeConfigFrom(
+            __DIR__.'/../config/pr.php',
+            'pr'
+        );
+
+        $this->app->singleton(PrServiceInterface::class, function ($app) {
+            $token = $this->resolveToken($app);
+
+            if ($token === null) {
+                throw new \RuntimeException(
+                    'GitHub token not configured. Set GITHUB_TOKEN environment variable or publish and configure the pr.php config file.'
+                );
+            }
+
+            return new GitHubPrService(new Connector($token));
+        });
+
+        $this->app->singleton(GitHubPrService::class, function ($app) {
+            return $app->make(PrServiceInterface::class);
+        });
+    }
+
+    /**
+     * Bootstrap services.
+     */
+    public function boot(): void
+    {
+        if ($this->app->runningInConsole()) {
+            $this->publishes([
+                __DIR__.'/../config/pr.php' => config_path('pr.php'),
+            ], 'pr-config');
+        }
+
+        // Auto-configure the PullRequests facade only if token is available
+        // This prevents crashing apps that don't need PR functionality
+        if ($this->resolveToken($this->app) !== null) {
+            PullRequests::setService($this->app->make(PrServiceInterface::class));
+        }
+    }
+
+    /**
+     * Resolve the GitHub token from available configuration sources.
+     *
+     * @param  \Illuminate\Contracts\Foundation\Application  $app
+     */
+    private function resolveToken($app): ?string
+    {
+        $sources = [
+            $app['config']->get('pr.github.token'),
+            $app['config']->get('services.github.token'),
+            env('GITHUB_TOKEN'),
+        ];
+
+        foreach ($sources as $token) {
+            if (is_string($token) && trim($token) !== '') {
+                return trim($token);
+            }
+        }
+
+        return null;
+    }
+}