disposable email utility added

Author: tamedevelopers

src/Cookie.php

@@ -7,7 +7,7 @@
 use Tamedevelopers\Support\Str;
 use Tamedevelopers\Support\Time;
 
-class Cookie{
+final class Cookie{
 
     /** 
      * Site name 
@@ -57,10 +57,10 @@ protected static function init()
 
     /** 
      * Create Cookie
-     * @param string $name
+     * @param mixed $name
      * - Cookie Name
      * 
-     * @param string|null $value
+     * @param mixed $value
      * - Cookie Value
      * 
      * @param int|string $minutes
@@ -99,6 +99,9 @@ public static function set($name, $value = null, $minutes = 0, $path = null, $do
             $path, $value, $domain, $secure, $httponly, $force
         );
 
+        $name = self::getItemValue($name);
+        $value = self::getItemValue($value);
+
         // Prefer new setcookie signature with array options (PHP 7.3+), fallback otherwise
         if (!headers_sent() || $force === true) {
             $options = [
@@ -113,28 +116,28 @@ public static function set($name, $value = null, $minutes = 0, $path = null, $do
             // Try modern signature; if it fails (older PHP), fallback to legacy
             try {
                 if (PHP_VERSION_ID >= 70300) {
-                    @setcookie($name, (string) $value, $options);
+                    @setcookie($name, $value, $options);
                 } else {
-                    @setcookie($name, (string) $value, (int) $expires, (string) $path, (string) $domain, (bool) $secure, (bool) $httponly);
+                    @setcookie($name, $value, (int) $expires, (string) $path, (string) $domain, (bool) $secure, (bool) $httponly);
                 }
             } catch (\Throwable $e) {
-                @setcookie($name, (string) $value, (int) $expires, (string) $path, (string) $domain, (bool) $secure, (bool) $httponly);
+                @setcookie($name, $value, (int) $expires, (string) $path, (string) $domain, (bool) $secure, (bool) $httponly);
             }
         }
     }
 
     /**
      * Expire the given cookie.
      *
-     * @param  string  $name
+     * @param  mixed  $name
      * @param  string|null  $path
      * @param  string|null  $domain
      * @return void
      */
     public static function forget($name, $path = null, $domain = null)
     {
         self::set(
-            name: $name,
+            name: self::getItemValue($name),
             minutes: 'last year', 
             path: $path, 
             domain: $domain,
@@ -145,7 +148,7 @@ public static function forget($name, $path = null, $domain = null)
     /**
      * Expire the given cookie.
      *
-     * @param  string  $name
+     * @param  mixed  $name
      * @param  string|null  $path
      * @param  string  $domain
      * @return void
@@ -198,26 +201,28 @@ public static function getExpire()
     /** 
      * Cookie has name that exists
      * 
-     * @param string $name
+     * @param mixed $name
      * - Cookie name
      * 
      * @return bool
      */
     public static function has($name = null)
     {
-        return isset($_COOKIE[(string) $name]);
+        return isset($_COOKIE[self::getItemValue($name)]);
     }
 
     /** 
      * Get cookie 
-     * @param string $name
+     * @param mixed $name
      * - Cookie name
      * 
      * @return mixed
      */
     public static function get($name = null)
     {
-        return self::has($name) ? $_COOKIE[(string) $name] : null;
+        $name = self::getItemValue($name);
+
+        return self::has($name) ? $_COOKIE[$name] : null;
     }
 
     /** 
@@ -232,6 +237,21 @@ public static function all($name = null)
     {
         return self::get($name) ?? $_COOKIE;
     }
+    
+    /**
+     * Item Value
+     *
+     * @param  mixed $value
+     * @return string
+     */
+    private static function getItemValue($value = null)
+    {
+        if(is_array($value)){
+            $value = Str::head($value);
+        }
+
+        return (string) $value;
+    }
 
     /** 
      * Set minutes

src/Process/Session/Handlers/RedisSessionHandler.php

@@ -44,7 +44,8 @@ public function __construct(
         int $ttl = 1440
     ) {
         // Avoid hard typehint to keep IDE analyzers happy when extension is missing
-        $this->redis = new \Redis();
+        $className = '\Redis';
+        $this->redis = new $className();
         $this->redis->connect($host, $port, $timeout);
         if ($auth !== null && $auth !== '') {
             $this->redis->auth($auth);

src/Str.php

@@ -240,7 +240,7 @@ public static function forgetArrayKeys($array, ...$keys)
      *
      * @param array $array The input data array.
      * @param string $key The key to use for conversion.
-     * @param int $case The case sensitivity option for key comparison (upper, lower).
+     * @param string $case The case sensitivity option for key comparison (upper, lower).
      * 
      * @return array
      * - The converted array with specified key as keys if available, else the original array

src/Tame.php

@@ -663,7 +663,7 @@ public static function isArraySame(?array $data = [])
      * 
      * @return array
      */
-    public static function sortArray(?array &$data = [], ?string $type = 'sort')
+    public static function sortArray(&$data = [], $type = 'sort')
     {
         // Validate that $data is an array
         if (!is_array($data)) {

src/Time.php

@@ -23,7 +23,7 @@
  *
  * All methods are documented at their definitions for clarity.
  */
-class Time {
+final class Time {
 
     use TimeTrait, TimeExtraTrait;
 

src/Traits/StrTrait.php

@@ -41,7 +41,7 @@ public static function changeKeysFromArray($array, $fromKey, $toKey = null): arr
      *
      * @param array $array The input data array.
      * @param string $key The key to use for conversion.
-     * @param int $case The case sensitivity option for key comparison (upper, lower).
+     * @param string $case The case sensitivity option for key comparison (upper, lower).
      * 
      * @return array
      * - The converted array with specified key as keys if available, else the original array
@@ -206,7 +206,7 @@ private static function replaceSubject($subject = null): mixed
      * Convert the case of a string based on the specified type.
      *
      * @param mixed $string The input string
-     * @param string|int|null $type   The case to convert: 'lower', 'upper', or 'unchanged'
+     * @param string|null $type   The case to convert: 'lower', 'upper', or 'unchanged'
      *
      * @return string The string with converted case
      */

src/Traits/TimeTrait.php

@@ -34,7 +34,7 @@ protected static function isTimeInstance()
 
     /**
      * Added a base resolver to reuse the latest instance context
-     * @return $this
+     * @return \Time
      */
     private static function baseInstance()
     {
@@ -52,7 +52,7 @@ private static function baseInstance()
      * - Only if no static data available, bind it to the passed clone object
      *
      * @param \Time $clone
-     * @return $this
+     * @return \Time
      */
     private static function keepStaticBinding($clone)
     {
@@ -66,7 +66,7 @@ private static function keepStaticBinding($clone)
     /**
      * Clone a new instance of the owning class.
      *
-     * @return $this A shallow clone of the current instance.
+     * @return \Time A shallow clone of the current instance.
      */
     private function clone()
     {
@@ -315,7 +315,7 @@ private static function nonExistMethod($method = null, $args = null, $clone = nu
             'gettimezone' => '__getTimezone',
             'settimezone' => '__setTimezone',
             'diffbetween', 'timediffbetween' => '__timeDifferenceBetween',
-            'diff', 'timediff' => '__timeDifference',
+            'diff', 'timediff', 'timedifference' => '__timeDifference',
             'daterange', 'range' => 'dateRange',
             'ago', 'timeago' => '__timeAgo',
             'addsecond' => 'addSeconds',