Add Laravel Pennant feature flag integration

Author: stayallive

.github/workflows/ci.yaml

@@ -154,7 +154,8 @@ jobs:
           # friendsofphp/php-cs-fixer: No need for this package to run phpunit and it conflicts with older Laravel versions
           # livewire/livewire: Only supported on Laravel 7.0 and above
           # laravel/folio: Only supported on PHP 8.1 + Laravel 10.0 and above
-          composer remove friendsofphp/php-cs-fixer livewire/livewire laravel/folio --dev --no-interaction --no-update
+          # laravel/pennant: Only supported on PHP 8.1 + Laravel 10.0 and above
+          composer remove friendsofphp/php-cs-fixer livewire/livewire laravel/folio laravel/pennant --dev --no-interaction --no-update
 
           # Require the correct versions we want to run phpunit for
           composer require \

composer.json

@@ -25,7 +25,7 @@
     "require": {
         "php": "^7.2 | ^8.0",
         "illuminate/support": "^6.0 | ^7.0 | ^8.0 | ^9.0 | ^10.0 | ^11.0 | ^12.0",
-        "sentry/sentry": "^4.16.0",
+        "sentry/sentry": "^4.18.0",
         "symfony/psr-http-message-bridge": "^1.0 | ^2.0 | ^6.0 | ^7.0",
         "nyholm/psr7": "^1.0"
     },
@@ -35,15 +35,16 @@
         }
     },
     "require-dev": {
-        "phpunit/phpunit": "^8.4 | ^9.3 | ^10.4 | ^11.5",
+        "friendsofphp/php-cs-fixer": "^3.11",
+        "guzzlehttp/guzzle": "^7.2",
+        "laravel/folio": "^1.1",
         "laravel/framework": "^6.0 | ^7.0 | ^8.0 | ^9.0 | ^10.0 | ^11.0 | ^12.0",
+        "laravel/pennant": "^1.0",
         "livewire/livewire": "^2.0 | ^3.0",
-        "orchestra/testbench": "^4.7 | ^5.1 | ^6.0 | ^7.0 | ^8.0 | ^9.0 | ^10.0",
-        "friendsofphp/php-cs-fixer": "^3.11",
         "mockery/mockery": "^1.3",
+        "orchestra/testbench": "^4.7 | ^5.1 | ^6.0 | ^7.0 | ^8.0 | ^9.0 | ^10.0",
         "phpstan/phpstan": "^1.10",
-        "laravel/folio": "^1.1",
-        "guzzlehttp/guzzle": "^7.2"
+        "phpunit/phpunit": "^8.4 | ^9.3 | ^10.4 | ^11.5"
     },
     "autoload-dev": {
         "psr-4": {

src/Sentry/Laravel/Features/PennantPackageIntegration.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Sentry\Laravel\Features;
+
+use Sentry\State\Scope;
+use Illuminate\Contracts\Events\Dispatcher;
+use Sentry\SentrySdk;
+use Laravel\Pennant\Feature as Pennant;
+use Laravel\Pennant\Events\FeatureResolved;
+use Laravel\Pennant\Events\FeatureRetrieved;
+
+class PennantPackageIntegration extends Feature
+{
+    private const FEATURE_KEY = 'pennant';
+
+    public function isApplicable(): bool
+    {
+        return class_exists(Pennant::class);
+    }
+
+    public function onBoot(Dispatcher $events): void
+    {
+        $events->listen(FeatureRetrieved::class, [$this, 'handleFeatureRetrieved']);
+    }
+
+    public function handleFeatureRetrieved($feature): void
+    {
+        if (!is_bool($feature->value)) {
+            return; // rich features are not supported yet
+        }
+
+        SentrySdk::getCurrentHub()->configureScope(function (Scope $scope) use ($feature) {
+            // The value of the feature is not always a bool (Rich Feature Values) but only bools are supported.
+            // The feature is considered "active" if its value is not explicitly false following Pennant's logic.
+            $scope->addFeatureFlag($feature->feature, $feature->value !== false);
+        });
+    }
+}

src/Sentry/Laravel/ServiceProvider.php

@@ -74,6 +74,7 @@ class ServiceProvider extends BaseServiceProvider
         Features\HttpClientIntegration::class,
         Features\FolioPackageIntegration::class,
         Features\NotificationsIntegration::class,
+        Features\PennantPackageIntegration::class,
         Features\LivewirePackageIntegration::class,
         Features\ConsoleSchedulingIntegration::class,
     ];