always-on config item allows features to always be on

Author: stevethomas

config/feature-flags.php

@@ -13,6 +13,18 @@
 
     'features' => [],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Always On
+    |--------------------------------------------------------------------------
+    |
+    | Declare the environments where features will be synced to the on
+    | state. This is useful if features should always be on locally.
+    | Note this only impacts the behaviour of the sync action.
+    */
+
+    'always_on' => [],
+
     /*
     |--------------------------------------------------------------------------
     | Cache

src/Actions/SyncFeaturesAction.php

@@ -3,6 +3,7 @@
 namespace Codinglabs\FeatureFlags\Actions;
 
 use Codinglabs\FeatureFlags\Models\Feature;
+use Codinglabs\FeatureFlags\Enums\FeatureState;
 
 class SyncFeaturesAction
 {
@@ -11,7 +12,9 @@ public function __invoke(): void
         $features = collect(config('feature-flags.features'))
             ->map(fn ($state, $name) => [
                 'name' => $name,
-                'state' => $state
+                'state' => app()->environment(config('feature-flags.always_on', []))
+                    ? FeatureState::on()
+                    : $state
             ]);
 
         $featureModels = Feature::all();

tests/SyncFeaturesActionTest.php

@@ -110,3 +110,67 @@
         'name' => 'some-other-feature',
     ]);
 });
+
+it('overrides the state when the always on config is used and the environment matches', function () {
+    app()->detectEnvironment(fn () => 'staging');
+
+    config([
+        'feature-flags.features' => [
+            'some-feature' => FeatureState::on(),
+            'some-other-feature' => FeatureState::off(),
+            'some-dynamic-feature' => FeatureState::dynamic(),
+        ],
+        'feature-flags.always_on' => ['staging'],
+    ]);
+
+    (new SyncFeaturesAction)->__invoke();
+
+    $this->assertDatabaseCount('features', 3);
+
+    $this->assertDatabaseHas('features', [
+        'name' => 'some-feature',
+        'state' => FeatureState::on(),
+    ]);
+
+    $this->assertDatabaseHas('features', [
+        'name' => 'some-other-feature',
+        'state' => FeatureState::on(),
+    ]);
+
+    $this->assertDatabaseHas('features', [
+        'name' => 'some-dynamic-feature',
+        'state' => FeatureState::on(),
+    ]);
+});
+
+it('does not override the state when the always on environment does not match', function () {
+    app()->detectEnvironment(fn () => 'production');
+
+    config([
+        'feature-flags.features' => [
+            'some-feature' => FeatureState::on(),
+            'some-other-feature' => FeatureState::off(),
+            'some-dynamic-feature' => FeatureState::dynamic(),
+        ],
+        'feature-flags.always_on' => ['local', 'staging'],
+    ]);
+
+    (new SyncFeaturesAction)->__invoke();
+
+    $this->assertDatabaseCount('features', 3);
+
+    $this->assertDatabaseHas('features', [
+        'name' => 'some-feature',
+        'state' => FeatureState::on(),
+    ]);
+
+    $this->assertDatabaseHas('features', [
+        'name' => 'some-other-feature',
+        'state' => FeatureState::off(),
+    ]);
+
+    $this->assertDatabaseHas('features', [
+        'name' => 'some-dynamic-feature',
+        'state' => FeatureState::dynamic(),
+    ]);
+});