feat: add support for backed enum plans

.gitattributes

@@ -10,6 +10,7 @@
 /tests export-ignore
 /.editorconfig export-ignore
 /.php-cs-fixer.dist.php export-ignore
+/workbench export-ignore
 /art export-ignore
 /docs export-ignore
 /UPGRADING.md export-ignore

composer.json

@@ -37,7 +37,8 @@
     },
     "autoload-dev": {
         "psr-4": {
-            "Maartenpaauw\\Filament\\Cashier\\Tests\\": "tests"
+            "Maartenpaauw\\Filament\\Cashier\\Tests\\": "tests",
+            "Workbench\\App\\": "workbench/app/"
         }
     },
     "scripts": {

src/Stripe/BillingProvider.php

@@ -4,6 +4,7 @@
 
 namespace Maartenpaauw\Filament\Cashier\Stripe;
 
+use BackedEnum;
 use Closure;
 use Filament\Billing\Providers\Contracts\Provider;
 use Filament\Pages\Dashboard;
@@ -13,7 +14,7 @@
 final class BillingProvider implements Provider
 {
     public function __construct(
-        private readonly string $plan = 'default',
+        private readonly string|BackedEnum $plan = 'default',
     ) {}
 
     public function getRouteAction(): string|Closure|array

src/Stripe/RedirectIfUserNotSubscribed.php

@@ -4,6 +4,7 @@
 
 namespace Maartenpaauw\Filament\Cashier\Stripe;
 
+use BackedEnum;
 use Closure;
 use Exception;
 use Filament\Pages\Dashboard;
@@ -59,8 +60,11 @@ public function handle(Request $request, Closure $next, string $plan = 'default'
             ->redirect();
     }
 
-    public static function plan(string $plan = 'default'): string
+    public static function plan(string|BackedEnum $plan = 'default'): string
     {
-        return sprintf('%s:%s', self::class, $plan);
+        return sprintf('%s:%s', self::class, match (true) {
+            $plan instanceof BackedEnum => strval($plan->value),
+            default => $plan,
+        });
     }
 }

tests/BillingProviderTest.php

@@ -3,15 +3,26 @@
 declare(strict_types=1);
 
 use Maartenpaauw\Filament\Cashier\Stripe\BillingProvider;
+use Workbench\App\enums\Plan;
 
-it('should use the defined plan', function () {
+it('should use the defined plan', function (): void {
     expect(new BillingProvider('basic'))
         ->getSubscribedMiddleware()
         ->toEqual('Maartenpaauw\Filament\Cashier\Stripe\RedirectIfUserNotSubscribed:basic');
 });
 
-it('should use the default plan when no plan provided', function () {
+it('should use the default plan when no plan provided', function (): void {
     expect(new BillingProvider)
         ->getSubscribedMiddleware()
         ->toEqual('Maartenpaauw\Filament\Cashier\Stripe\RedirectIfUserNotSubscribed:default');
 });
+
+it('should use the value from string backed enums as plan name', function (BackedEnum $plan, string $expectedMiddleware): void {
+    expect(new BillingProvider($plan))
+        ->getSubscribedMiddleware()
+        ->toEqual($expectedMiddleware);
+})->with([
+    [Plan::Basic, 'Maartenpaauw\Filament\Cashier\Stripe\RedirectIfUserNotSubscribed:basic'],
+    [Plan::Advanced, 'Maartenpaauw\Filament\Cashier\Stripe\RedirectIfUserNotSubscribed:advanced'],
+    [Plan::Premium, 'Maartenpaauw\Filament\Cashier\Stripe\RedirectIfUserNotSubscribed:premium'],
+]);

workbench/app/enums/Plan.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Workbench\App\enums;
+
+enum Plan: string
+{
+    case Basic = 'basic';
+    case Advanced = 'advanced';
+    case Premium = 'premium';
+}