Add enum support to Cookie, Js, ThrottleRequests, and PendingBatch

binaryfire · binaryfire · commit 795cad78da5a · 2026-01-18T09:47:22.000Z
- Cookie: has(), get(), make(), expire(), unqueue(), forever(), forget()
- Js: Changed BackedEnum to UnitEnum, use enum_value()
- ThrottleRequests::using(): Accept enum limiter names
- PendingBatch/PendingChain::onConnection(): Accept enum connection names
- Updated facade docblocks via facade-documenter
- Added comprehensive enum tests
diff --git a/src/bus/src/PendingBatch.php b/src/bus/src/PendingBatch.php
@@ -194,9 +194,9 @@ public function name(string $name): static
     /**
      * Specify the queue connection that the batched jobs should run on.
      */
-    public function onConnection(string $connection): static
+    public function onConnection(UnitEnum|string $connection): static
     {
-        $this->options['connection'] = $connection;
+        $this->options['connection'] = enum_value($connection);
 
         return $this;
     }
diff --git a/src/bus/src/PendingChain.php b/src/bus/src/PendingChain.php
@@ -56,9 +56,9 @@ public function __construct(
     /**
      * Set the desired connection for the job.
      */
-    public function onConnection(?string $connection): static
+    public function onConnection(UnitEnum|string|null $connection): static
     {
-        $this->connection = $connection;
+        $this->connection = enum_value($connection);
 
         return $this;
     }
diff --git a/src/cookie/src/Contracts/Cookie.php b/src/cookie/src/Contracts/Cookie.php
@@ -5,24 +5,25 @@
 namespace Hypervel\Cookie\Contracts;
 
 use Hyperf\HttpMessage\Cookie\Cookie as HyperfCookie;
+use UnitEnum;
 
 interface Cookie
 {
-    public function has(string $key): bool;
+    public function has(UnitEnum|string $key): bool;
 
-    public function get(string $key, ?string $default = null): ?string;
+    public function get(UnitEnum|string $key, ?string $default = null): ?string;
 
-    public function make(string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): HyperfCookie;
+    public function make(UnitEnum|string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): HyperfCookie;
 
     public function queue(...$parameters): void;
 
-    public function expire(string $name, string $path = '', string $domain = ''): void;
+    public function expire(UnitEnum|string $name, string $path = '', string $domain = ''): void;
 
-    public function unqueue(string $name, string $path = ''): void;
+    public function unqueue(UnitEnum|string $name, string $path = ''): void;
 
     public function getQueuedCookies(): array;
 
-    public function forever(string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): HyperfCookie;
+    public function forever(UnitEnum|string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): HyperfCookie;
 
-    public function forget(string $name, string $path = '', string $domain = ''): HyperfCookie;
+    public function forget(UnitEnum|string $name, string $path = '', string $domain = ''): HyperfCookie;
 }
diff --git a/src/cookie/src/CookieManager.php b/src/cookie/src/CookieManager.php
@@ -9,6 +9,9 @@
 use Hyperf\HttpServer\Contract\RequestInterface;
 use Hyperf\Support\Traits\InteractsWithTime;
 use Hypervel\Cookie\Contracts\Cookie as CookieContract;
+use UnitEnum;
+
+use function Hypervel\Support\enum_value;
 
 class CookieManager implements CookieContract
 {
@@ -19,25 +22,25 @@ public function __construct(
     ) {
     }
 
-    public function has(string $key): bool
+    public function has(UnitEnum|string $key): bool
     {
         return ! is_null($this->get($key));
     }
 
-    public function get(string $key, ?string $default = null): ?string
+    public function get(UnitEnum|string $key, ?string $default = null): ?string
     {
         if (! RequestContext::has()) {
             return null;
         }
 
-        return $this->request->cookie($key, $default);
+        return $this->request->cookie(enum_value($key), $default);
     }
 
-    public function make(string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie
+    public function make(UnitEnum|string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie
     {
         $time = ($minutes == 0) ? 0 : $this->availableAt($minutes * 60);
 
-        return new Cookie($name, $value, $time, $path, $domain, $secure, $httpOnly, $raw, $sameSite);
+        return new Cookie(enum_value($name), $value, $time, $path, $domain, $secure, $httpOnly, $raw, $sameSite);
     }
 
     public function queue(...$parameters): void
@@ -51,13 +54,15 @@ public function queue(...$parameters): void
         $this->appendToQueue($cookie);
     }
 
-    public function expire(string $name, string $path = '', string $domain = ''): void
+    public function expire(UnitEnum|string $name, string $path = '', string $domain = ''): void
     {
         $this->queue($this->forget($name, $path, $domain));
     }
 
-    public function unqueue(string $name, string $path = ''): void
+    public function unqueue(UnitEnum|string $name, string $path = ''): void
     {
+        $name = enum_value($name);
+
         $cookies = $this->getQueuedCookies();
         if ($path === '') {
             unset($cookies[$name]);
@@ -93,12 +98,12 @@ protected function setQueueCookies(array $cookies): array
         return Context::set('http.cookies.queue', $cookies);
     }
 
-    public function forever(string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie
+    public function forever(UnitEnum|string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie
     {
         return $this->make($name, $value, 2628000, $path, $domain, $secure, $httpOnly, $raw, $sameSite);
     }
 
-    public function forget(string $name, string $path = '', string $domain = ''): Cookie
+    public function forget(UnitEnum|string $name, string $path = '', string $domain = ''): Cookie
     {
         return $this->make($name, '', -2628000, $path, $domain);
     }
diff --git a/src/router/src/Middleware/ThrottleRequests.php b/src/router/src/Middleware/ThrottleRequests.php
@@ -19,6 +19,9 @@
 use Psr\Http\Server\MiddlewareInterface;
 use Psr\Http\Server\RequestHandlerInterface;
 use RuntimeException;
+use UnitEnum;
+
+use function Hypervel\Support\enum_value;
 
 class ThrottleRequests implements MiddlewareInterface
 {
@@ -45,9 +48,9 @@ public function __construct(RateLimiter $limiter)
     /**
      * Specify the named rate limiter to use for the middleware.
      */
-    public static function using(string $name): string
+    public static function using(UnitEnum|string $name): string
     {
-        return static::class . ':' . $name;
+        return static::class . ':' . enum_value($name);
     }
 
     /**
diff --git a/src/support/src/Facades/Cache.php b/src/support/src/Facades/Cache.php
@@ -43,7 +43,7 @@
  * @method static bool putMany(array $values, int $seconds)
  * @method static bool flush()
  * @method static string getPrefix()
- * @method static bool missing(string $key)
+ * @method static bool missing(\UnitEnum|string $key)
  * @method static bool supportsTags()
  * @method static int|null getDefaultCacheTime()
  * @method static \Hypervel\Cache\Repository setDefaultCacheTime(int|null $seconds)
diff --git a/src/support/src/Facades/Cookie.php b/src/support/src/Facades/Cookie.php
@@ -7,15 +7,15 @@
 use Hypervel\Cookie\Contracts\Cookie as CookieContract;
 
 /**
- * @method static bool has(string $key)
- * @method static string|null get(string $key, string|null $default = null)
- * @method static \Hypervel\Cookie\Cookie make(string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, string|null $sameSite = null)
+ * @method static bool has(\UnitEnum|string $key)
+ * @method static string|null get(\UnitEnum|string $key, string|null $default = null)
+ * @method static \Hypervel\Cookie\Cookie make(\UnitEnum|string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, string|null $sameSite = null)
  * @method static void queue(mixed ...$parameters)
- * @method static void expire(string $name, string $path = '', string $domain = '')
- * @method static void unqueue(string $name, string $path = '')
+ * @method static void expire(\UnitEnum|string $name, string $path = '', string $domain = '')
+ * @method static void unqueue(\UnitEnum|string $name, string $path = '')
  * @method static array getQueuedCookies()
- * @method static \Hypervel\Cookie\Cookie forever(string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, string|null $sameSite = null)
- * @method static \Hypervel\Cookie\Cookie forget(string $name, string $path = '', string $domain = '')
+ * @method static \Hypervel\Cookie\Cookie forever(\UnitEnum|string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, string|null $sameSite = null)
+ * @method static \Hypervel\Cookie\Cookie forget(\UnitEnum|string $name, string $path = '', string $domain = '')
  *
  * @see \Hypervel\Cookie\CookieManager
  */
diff --git a/src/support/src/Facades/Gate.php b/src/support/src/Facades/Gate.php
@@ -7,21 +7,21 @@
 use Hypervel\Auth\Contracts\Gate as GateContract;
 
 /**
- * @method static bool has(array|string $ability)
+ * @method static bool has(\UnitEnum|array|string $ability)
  * @method static \Hypervel\Auth\Access\Response allowIf(\Closure|\Hypervel\Auth\Access\Response|bool $condition, string|null $message = null, string|null $code = null)
  * @method static \Hypervel\Auth\Access\Response denyIf(\Closure|\Hypervel\Auth\Access\Response|bool $condition, string|null $message = null, string|null $code = null)
- * @method static \Hypervel\Auth\Access\Gate define(string $ability, callable|array|string $callback)
+ * @method static \Hypervel\Auth\Access\Gate define(\UnitEnum|string $ability, callable|array|string $callback)
  * @method static \Hypervel\Auth\Access\Gate resource(string $name, string $class, array|null $abilities = null)
  * @method static \Hypervel\Auth\Access\Gate policy(string $class, string $policy)
  * @method static \Hypervel\Auth\Access\Gate before(callable $callback)
  * @method static \Hypervel\Auth\Access\Gate after(callable $callback)
- * @method static bool allows(string $ability, mixed $arguments = [])
- * @method static bool denies(string $ability, mixed $arguments = [])
- * @method static bool check(\Traversable|array|string $abilities, mixed $arguments = [])
- * @method static bool any(\Traversable|array|string $abilities, mixed $arguments = [])
- * @method static bool none(\Traversable|array|string $abilities, mixed $arguments = [])
- * @method static \Hypervel\Auth\Access\Response authorize(string $ability, mixed $arguments = [])
- * @method static \Hypervel\Auth\Access\Response inspect(string $ability, mixed $arguments = [])
+ * @method static bool allows(\UnitEnum|string $ability, mixed $arguments = [])
+ * @method static bool denies(\UnitEnum|string $ability, mixed $arguments = [])
+ * @method static bool check(\Traversable|\UnitEnum|array|string $abilities, mixed $arguments = [])
+ * @method static bool any(\Traversable|\UnitEnum|array|string $abilities, mixed $arguments = [])
+ * @method static bool none(\Traversable|\UnitEnum|array|string $abilities, mixed $arguments = [])
+ * @method static \Hypervel\Auth\Access\Response authorize(\UnitEnum|string $ability, mixed $arguments = [])
+ * @method static \Hypervel\Auth\Access\Response inspect(\UnitEnum|string $ability, mixed $arguments = [])
  * @method static mixed raw(string $ability, mixed $arguments = [])
  * @method static mixed|void getPolicyFor(object|string $class)
  * @method static mixed resolvePolicy(string $class)
diff --git a/src/support/src/Facades/RateLimiter.php b/src/support/src/Facades/RateLimiter.php
@@ -5,8 +5,8 @@
 namespace Hypervel\Support\Facades;
 
 /**
- * @method static \Hypervel\Cache\RateLimiter for(string $name, \Closure $callback)
- * @method static \Closure|null limiter(string $name)
+ * @method static \Hypervel\Cache\RateLimiter for(\UnitEnum|string $name, \Closure $callback)
+ * @method static \Closure|null limiter(\UnitEnum|string $name)
  * @method static mixed attempt(string $key, int $maxAttempts, \Closure $callback, int $decaySeconds = 60)
  * @method static bool tooManyAttempts(string $key, int $maxAttempts)
  * @method static int hit(string $key, int $decaySeconds = 60)
diff --git a/src/support/src/Facades/Redis.php b/src/support/src/Facades/Redis.php
@@ -7,7 +7,7 @@
 use Hypervel\Redis\Redis as RedisClient;
 
 /**
- * @method static \Hypervel\Redis\RedisProxy connection(string $name = 'default')
+ * @method static \Hypervel\Redis\RedisProxy connection(\UnitEnum|string $name = 'default')
  * @method static void release()
  * @method static \Hypervel\Redis\RedisConnection shouldTransform(bool $shouldTransform = true)
  * @method static bool getShouldTransform()
diff --git a/src/support/src/Facades/Schedule.php b/src/support/src/Facades/Schedule.php
@@ -9,14 +9,14 @@
 /**
  * @method static \Hypervel\Console\Scheduling\CallbackEvent call(callable|string $callback, array $parameters = [])
  * @method static \Hypervel\Console\Scheduling\Event command(string $command, array $parameters = [])
- * @method static \Hypervel\Console\Scheduling\CallbackEvent job(object|string $job, string|null $queue = null, string|null $connection = null)
+ * @method static \Hypervel\Console\Scheduling\CallbackEvent job(object|string $job, \UnitEnum|string|null $queue = null, \UnitEnum|string|null $connection = null)
  * @method static \Hypervel\Console\Scheduling\Event exec(string $command, array $parameters = [], bool $isSystem = true)
  * @method static void group(\Closure $events)
  * @method static string compileArrayInput(string|int $key, array $value)
  * @method static bool serverShouldRun(\Hypervel\Console\Scheduling\Event $event, \DateTimeInterface $time)
  * @method static \Hyperf\Collection\Collection dueEvents(\Hypervel\Foundation\Contracts\Application $app)
  * @method static array events()
- * @method static \Hypervel\Console\Scheduling\Schedule useCache(string|null $store)
+ * @method static \Hypervel\Console\Scheduling\Schedule useCache(\UnitEnum|string|null $store)
  * @method static mixed macroCall(string $method, array $parameters)
  * @method static void macro(string $name, callable|object $macro)
  * @method static void mixin(object $mixin, bool $replace = true)
@@ -82,7 +82,7 @@
  * @method static \Hypervel\Console\Scheduling\PendingEventAttributes yearly()
  * @method static \Hypervel\Console\Scheduling\PendingEventAttributes yearlyOn(int $month = 1, int|string $dayOfMonth = 1, string $time = '0:0')
  * @method static \Hypervel\Console\Scheduling\PendingEventAttributes days(array|mixed $days)
- * @method static \Hypervel\Console\Scheduling\PendingEventAttributes timezone(\DateTimeZone|string $timezone)
+ * @method static \Hypervel\Console\Scheduling\PendingEventAttributes timezone(\DateTimeZone|\UnitEnum|string $timezone)
  *
  * @see \Hypervel\Console\Scheduling\Schedule
  */
diff --git a/src/support/src/Facades/Session.php b/src/support/src/Facades/Session.php
@@ -27,27 +27,27 @@
  * @method static array all()
  * @method static array only(array $keys)
  * @method static array except(array $keys)
- * @method static bool exists(array|string $key)
- * @method static bool missing(array|string $key)
- * @method static bool has(array|string $key)
- * @method static bool hasAny(array|string $key)
- * @method static mixed get(string $key, mixed $default = null)
- * @method static mixed pull(string $key, mixed $default = null)
- * @method static bool hasOldInput(string|null $key = null)
- * @method static mixed getOldInput(string|null $key = null, mixed $default = null)
+ * @method static bool exists(\UnitEnum|array|string $key)
+ * @method static bool missing(\UnitEnum|array|string $key)
+ * @method static bool has(\UnitEnum|array|string $key)
+ * @method static bool hasAny(\UnitEnum|array|string $key)
+ * @method static mixed get(\UnitEnum|string $key, mixed $default = null)
+ * @method static mixed pull(\UnitEnum|string $key, mixed $default = null)
+ * @method static bool hasOldInput(\UnitEnum|string|null $key = null)
+ * @method static mixed getOldInput(\UnitEnum|string|null $key = null, mixed $default = null)
  * @method static void replace(array $attributes)
- * @method static void put(array|string $key, mixed $value = null)
- * @method static mixed remember(string $key, \Closure $callback)
- * @method static void push(string $key, mixed $value)
- * @method static mixed increment(string $key, int $amount = 1)
- * @method static int decrement(string $key, int $amount = 1)
- * @method static void flash(string $key, mixed $value = true)
- * @method static void now(string $key, mixed $value)
+ * @method static void put(\UnitEnum|array|string $key, mixed $value = null)
+ * @method static mixed remember(\UnitEnum|string $key, \Closure $callback)
+ * @method static void push(\UnitEnum|string $key, mixed $value)
+ * @method static mixed increment(\UnitEnum|string $key, int $amount = 1)
+ * @method static int decrement(\UnitEnum|string $key, int $amount = 1)
+ * @method static void flash(\UnitEnum|string $key, mixed $value = true)
+ * @method static void now(\UnitEnum|string $key, mixed $value)
  * @method static void reflash()
  * @method static void keep(array|mixed $keys = null)
  * @method static void flashInput(array $value)
- * @method static mixed remove(string $key)
- * @method static void forget(array|string $keys)
+ * @method static mixed remove(\UnitEnum|string $key)
+ * @method static void forget(\UnitEnum|array|string $keys)
  * @method static void flush()
  * @method static bool invalidate()
  * @method static bool regenerate(bool $destroy = false)
diff --git a/src/support/src/Facades/Storage.php b/src/support/src/Facades/Storage.php
@@ -8,10 +8,13 @@
 use Hyperf\Contract\ConfigInterface;
 use Hypervel\Filesystem\Filesystem;
 use Hypervel\Filesystem\FilesystemManager;
+use UnitEnum;
+
+use function Hypervel\Support\enum_value;
 
 /**
- * @method static \Hypervel\Filesystem\Contracts\Filesystem drive(string|null $name = null)
- * @method static \Hypervel\Filesystem\Contracts\Filesystem disk(string|null $name = null)
+ * @method static \Hypervel\Filesystem\Contracts\Filesystem drive(\UnitEnum|string|null $name = null)
+ * @method static \Hypervel\Filesystem\Contracts\Filesystem disk(\UnitEnum|string|null $name = null)
  * @method static \Hypervel\Filesystem\Contracts\Cloud cloud()
  * @method static \Hypervel\Filesystem\Contracts\Filesystem build(array|string $config)
  * @method static \Hypervel\Filesystem\Contracts\Filesystem createLocalDriver(array $config, string $name = 'local')
@@ -125,9 +128,9 @@ class Storage extends Facade
      *
      * @return \Hypervel\Filesystem\Contracts\Filesystem
      */
-    public static function fake(?string $disk = null, array $config = [])
+    public static function fake(UnitEnum|string|null $disk = null, array $config = [])
     {
-        $disk = $disk ?: ApplicationContext::getContainer()
+        $disk = enum_value($disk) ?: ApplicationContext::getContainer()
             ->get(ConfigInterface::class)
             ->get('filesystems.default');
 
@@ -149,9 +152,9 @@ public static function fake(?string $disk = null, array $config = [])
      *
      * @return \Hypervel\Filesystem\Contracts\Filesystem
      */
-    public static function persistentFake(?string $disk = null, array $config = [])
+    public static function persistentFake(UnitEnum|string|null $disk = null, array $config = [])
     {
-        $disk = $disk ?: ApplicationContext::getContainer()
+        $disk = enum_value($disk) ?: ApplicationContext::getContainer()
             ->get(ConfigInterface::class)
             ->get('filesystems.default');
 
diff --git a/src/support/src/Js.php b/src/support/src/Js.php
@@ -4,14 +4,14 @@
 
 namespace Hypervel\Support;
 
-use BackedEnum;
 use Hyperf\Contract\Arrayable;
 use Hyperf\Contract\Jsonable;
 use Hyperf\Stringable\Str;
 use Hyperf\ViewEngine\Contract\Htmlable;
 use JsonException;
 use JsonSerializable;
 use Stringable;
+use UnitEnum;
 
 class Js implements Htmlable, Stringable
 {
@@ -58,8 +58,8 @@ protected function convertDataToJavaScriptExpression(mixed $data, int $flags = 0
             return $data->toHtml();
         }
 
-        if ($data instanceof BackedEnum) {
-            $data = $data->value;
+        if ($data instanceof UnitEnum) {
+            $data = enum_value($data);
         }
 
         $json = static::encode($data, $flags, $depth);
diff --git a/tests/Bus/BusPendingBatchTest.php b/tests/Bus/BusPendingBatchTest.php
diff --git a/tests/Cookie/CookieManagerTest.php b/tests/Cookie/CookieManagerTest.php
diff --git a/tests/Router/Middleware/ThrottleRequestsTest.php b/tests/Router/Middleware/ThrottleRequestsTest.php
diff --git a/tests/Support/JsTest.php b/tests/Support/JsTest.php

Original file line number	Diff line number	Diff line change
`@@ -194,9 +194,9 @@ public function name(string $name): static`
`194`	`194`	`/**`
`195`	`195`	`* Specify the queue connection that the batched jobs should run on.`
`196`	`196`	`*/`
`197`		`- public function onConnection(string $connection): static`
	`197`	`+ public function onConnection(UnitEnum\|string $connection): static`
`198`	`198`	`{`
`199`		`- $this->options['connection'] = $connection;`
	`199`	`+ $this->options['connection'] = enum_value($connection);`
`200`	`200`
`201`	`201`	`return $this;`
`202`	`202`	`}`
Original file line number	Diff line number	Diff line change
`@@ -56,9 +56,9 @@ public function __construct(`
`56`	`56`	`/**`
`57`	`57`	`* Set the desired connection for the job.`
`58`	`58`	`*/`
`59`		`- public function onConnection(?string $connection): static`
	`59`	`+ public function onConnection(UnitEnum\|string\|null $connection): static`
`60`	`60`	`{`
`61`		`- $this->connection = $connection;`
	`61`	`+ $this->connection = enum_value($connection);`
`62`	`62`
`63`	`63`	`return $this;`
`64`	`64`	`}`
Original file line number	Diff line number	Diff line change
`@@ -9,6 +9,9 @@`
`9`	`9`	`use Hyperf\HttpServer\Contract\RequestInterface;`
`10`	`10`	`use Hyperf\Support\Traits\InteractsWithTime;`
`11`	`11`	`use Hypervel\Cookie\Contracts\Cookie as CookieContract;`
	`12`	`+use UnitEnum;`
	`13`	`+`
	`14`	`+use function Hypervel\Support\enum_value;`
`12`	`15`
`13`	`16`	`class CookieManager implements CookieContract`
`14`	`17`	`{`
`@@ -19,25 +22,25 @@ public function __construct(`
`19`	`22`	`) {`
`20`	`23`	`}`
`21`	`24`
`22`		`- public function has(string $key): bool`
	`25`	`+ public function has(UnitEnum\|string $key): bool`
`23`	`26`	`{`
`24`	`27`	`return ! is_null($this->get($key));`
`25`	`28`	`}`
`26`	`29`
`27`		`- public function get(string $key, ?string $default = null): ?string`
	`30`	`+ public function get(UnitEnum\|string $key, ?string $default = null): ?string`
`28`	`31`	`{`
`29`	`32`	`if (! RequestContext::has()) {`
`30`	`33`	`return null;`
`31`	`34`	`}`
`32`	`35`
`33`		`- return $this->request->cookie($key, $default);`
	`36`	`+ return $this->request->cookie(enum_value($key), $default);`
`34`	`37`	`}`
`35`	`38`
`36`		`- public function make(string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie`
	`39`	`+ public function make(UnitEnum\|string $name, string $value, int $minutes = 0, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie`
`37`	`40`	`{`
`38`	`41`	`$time = ($minutes == 0) ? 0 : $this->availableAt($minutes * 60);`
`39`	`42`
`40`		`- return new Cookie($name, $value, $time, $path, $domain, $secure, $httpOnly, $raw, $sameSite);`
	`43`	`+ return new Cookie(enum_value($name), $value, $time, $path, $domain, $secure, $httpOnly, $raw, $sameSite);`
`41`	`44`	`}`
`42`	`45`
`43`	`46`	`public function queue(...$parameters): void`
`@@ -51,13 +54,15 @@ public function queue(...$parameters): void`
`51`	`54`	`$this->appendToQueue($cookie);`
`52`	`55`	`}`
`53`	`56`
`54`		`- public function expire(string $name, string $path = '', string $domain = ''): void`
	`57`	`+ public function expire(UnitEnum\|string $name, string $path = '', string $domain = ''): void`
`55`	`58`	`{`
`56`	`59`	`$this->queue($this->forget($name, $path, $domain));`
`57`	`60`	`}`
`58`	`61`
`59`		`- public function unqueue(string $name, string $path = ''): void`
	`62`	`+ public function unqueue(UnitEnum\|string $name, string $path = ''): void`
`60`	`63`	`{`
	`64`	`+ $name = enum_value($name);`
	`65`	`+`
`61`	`66`	`$cookies = $this->getQueuedCookies();`
`62`	`67`	`if ($path === '') {`
`63`	`68`	`unset($cookies[$name]);`
`@@ -93,12 +98,12 @@ protected function setQueueCookies(array $cookies): array`
`93`	`98`	`return Context::set('http.cookies.queue', $cookies);`
`94`	`99`	`}`
`95`	`100`
`96`		`- public function forever(string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie`
	`101`	`+ public function forever(UnitEnum\|string $name, string $value, string $path = '', string $domain = '', bool $secure = false, bool $httpOnly = true, bool $raw = false, ?string $sameSite = null): Cookie`
`97`	`102`	`{`
`98`	`103`	`return $this->make($name, $value, 2628000, $path, $domain, $secure, $httpOnly, $raw, $sameSite);`
`99`	`104`	`}`
`100`	`105`
`101`		`- public function forget(string $name, string $path = '', string $domain = ''): Cookie`
	`106`	`+ public function forget(UnitEnum\|string $name, string $path = '', string $domain = ''): Cookie`
`102`	`107`	`{`
`103`	`108`	`return $this->make($name, '', -2628000, $path, $domain);`
`104`	`109`	`}`
Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,9 @@`
`19`	`19`	`use Psr\Http\Server\MiddlewareInterface;`
`20`	`20`	`use Psr\Http\Server\RequestHandlerInterface;`
`21`	`21`	`use RuntimeException;`
	`22`	`+use UnitEnum;`
	`23`	`+`
	`24`	`+use function Hypervel\Support\enum_value;`
`22`	`25`
`23`	`26`	`class ThrottleRequests implements MiddlewareInterface`
`24`	`27`	`{`
`@@ -45,9 +48,9 @@ public function __construct(RateLimiter $limiter)`
`45`	`48`	`/**`
`46`	`49`	`* Specify the named rate limiter to use for the middleware.`
`47`	`50`	`*/`
`48`		`- public static function using(string $name): string`
	`51`	`+ public static function using(UnitEnum\|string $name): string`
`49`	`52`	`{`
`50`		`- return static::class . ':' . $name;`
	`53`	`+ return static::class . ':' . enum_value($name);`
`51`	`54`	`}`
`52`	`55`
`53`	`56`	`/**`