Make throttle rate configurable via routes() and legacyRoutes() parameters

Users can now pass a custom rate or disable throttling entirely via named
parameters, rather than having a hardcoded '60,1' rate:

  Subscriber::routes(throttle: '10,1');   // custom rate
  Subscriber::routes(throttle: false);    // disable

The default remains '60,1'. FakeSubscriber, facade docblock, and the
published stub are updated to match.

https://claude.ai/code/session_01R4pAjWwGY8xKspsdU8xnsy

Author: claude

src/Facades/Subscriber.php

@@ -11,8 +11,8 @@
  *
  * @see \YlsIdeas\SubscribableNotifications\Subscriber
  *
- * @method static void routes()
- * @method static void legacyRoutes(string $defaultModel)
+ * @method static void routes(mixed $router = null, string|false $throttle = '60,1')
+ * @method static void legacyRoutes(string $defaultModel, mixed $router = null, string|false $throttle = '60,1')
  * @method static string routeName()
  * @method static void onCompletion(callable|string $handler)
  * @method static void onUnsubscribeFromMailingList(callable|string $handler)

src/Subscriber.php

@@ -30,28 +30,34 @@ public function __construct(private readonly Application $app)
     {
     }
 
-    public function routes(mixed $router = null): void
+    public function routes(mixed $router = null, string|false $throttle = '60,1'): void
     {
         $router = $router ?? $this->app->make('router');
-        $router->match(['GET', 'POST'], $this->uri, $this->handler)
+        $route = $router->match(['GET', 'POST'], $this->uri, $this->handler)
             ->name($this->routeName)
-            ->where('subscriberType', '[^\d/][^/]*')
-            ->middleware('throttle:60,1');
+            ->where('subscriberType', '[^\d/][^/]*');
+
+        if ($throttle !== false) {
+            $route->middleware("throttle:{$throttle}");
+        }
     }
 
-    public function legacyRoutes(string $defaultModel, mixed $router = null): void
+    public function legacyRoutes(string $defaultModel, mixed $router = null, string|false $throttle = '60,1'): void
     {
         $router = $router ?? $this->app->make('router');
 
         $morphMap = Relation::morphMap();
         $this->legacySubscriberType = array_search($defaultModel, $morphMap, true) ?: $defaultModel;
 
-        $router->match(
+        $route = $router->match(
             ['GET', 'POST'],
             'unsubscribe/{subscriberId}/{mailingList?}',
             '\YlsIdeas\SubscribableNotifications\Controllers\LegacyUnsubscribeController'
-        )->name($this->routeName . '.legacy')
-            ->middleware('throttle:60,1');
+        )->name($this->routeName . '.legacy');
+
+        if ($throttle !== false) {
+            $route->middleware("throttle:{$throttle}");
+        }
     }
 
     public function routeName(): string

src/Testing/FakeSubscriber.php

@@ -14,11 +14,11 @@ final class FakeSubscriber
     private array $subscriptionStatusChecks = [];
     private bool $subscriptionStatus = true;
 
-    public function routes(mixed $router = null): void
+    public function routes(mixed $router = null, string|false $throttle = '60,1'): void
     {
     }
 
-    public function legacyRoutes(string $defaultModel, mixed $router = null): void
+    public function legacyRoutes(string $defaultModel, mixed $router = null, string|false $throttle = '60,1'): void
     {
     }
 

stubs/SubscribableServiceProvider.stub

@@ -11,6 +11,9 @@ class SubscribableServiceProvider extends ServiceProvider
     {
         // Note: register this route outside the 'web' middleware group to avoid CSRF token
         // verification on the POST (RFC 8058 one-click) endpoint.
+        // The throttle defaults to '60,1' (60 requests per minute). Adjust or disable:
+        // Subscriber::routes(throttle: '10,1');
+        // Subscriber::routes(throttle: false);
         Subscriber::routes();
 
         Subscriber::onUnsubscribeFromMailingList(function ($notifiable, string $mailingList) {