Add comprehensive Cache method aliases and utilities

- Add forget() alias for invalidate()
- Add flush() alias for clear()
- Add stats() alias for getStats()
- Add set() alias for put()
- Add delete() and remove() aliases for invalidate()
- Add exists() alias for has()
- Add size() method to get cache entry count
- Add isExpired() to check if specific key expired
- Add getRemainingTtl() to get remaining TTL for key
- Add all() method to get all non-expired entries

Author: ImperaZim

src/imperazim/components/cache/Cache.php

@@ -152,6 +152,116 @@ public static function purgeExpired(): void {
     }
   }
 
+  /**
+  * Alias for invalidate() - removes a cached item.
+  * @param string $key The cache key.
+  */
+  public static function forget(string $key): void {
+    self::invalidate($key);
+  }
+
+  /**
+  * Alias for clear() - clears all cached data.
+  */
+  public static function flush(): void {
+    self::clear();
+  }
+
+  /**
+  * Alias for getStats() - returns cache statistics.
+  * @return array Cache statistics.
+  */
+  public static function stats(): array {
+    return self::getStats();
+  }
+
+  /**
+  * Alias for put() - stores a value in the cache.
+  * @param string $key The cache key.
+  * @param mixed $value The value to store.
+  * @param int|null $ttl Time to live in seconds (null for no expiration).
+  */
+  public static function set(string $key, mixed $value, ?int $ttl = null): void {
+    self::put($key, $value, $ttl);
+  }
+
+  /**
+  * Alias for invalidate() - removes a cached item.
+  * @param string $key The cache key.
+  */
+  public static function delete(string $key): void {
+    self::invalidate($key);
+  }
+
+  /**
+  * Alias for invalidate() - removes a cached item.
+  * @param string $key The cache key.
+  */
+  public static function remove(string $key): void {
+    self::invalidate($key);
+  }
+
+  /**
+  * Alias for has() - checks if a key exists in the cache.
+  * @param string $key The cache key.
+  * @return bool True if the key exists and is not expired.
+  */
+  public static function exists(string $key): bool {
+    return self::has($key);
+  }
+
+  /**
+  * Returns the number of entries in the cache.
+  * @return int Number of cached entries.
+  */
+  public static function size(): int {
+    return count(self::$cache);
+  }
+
+  /**
+  * Checks if a specific cache key has expired.
+  * @param string $key The cache key.
+  * @return bool True if the key exists but has expired.
+  */
+  public static function isExpired(string $key): bool {
+    if (!isset(self::$cache[$key])) {
+      return false; // Key doesn't exist, so it's not "expired" - it never existed
+    }
+    $item = self::$cache[$key];
+    return $item['expires_at'] !== null && $item['expires_at'] < time();
+  }
+
+  /**
+  * Gets the remaining TTL (time to live) for a cache key in seconds.
+  * @param string $key The cache key.
+  * @return int|null Remaining TTL in seconds, or null if key doesn't exist or has no expiration.
+  */
+  public static function getRemainingTtl(string $key): ?int {
+    if (!isset(self::$cache[$key])) {
+      return null;
+    }
+    $item = self::$cache[$key];
+    if ($item['expires_at'] === null) {
+      return null; // No expiration
+    }
+    $remaining = $item['expires_at'] - time();
+    return max(0, $remaining); // Don't return negative values
+  }
+
+  /**
+  * Returns all cache entries as an associative array.
+  * @return array All cache entries [key => value].
+  */
+  public static function all(): array {
+    $result = [];
+    foreach (self::$cache as $key => $item) {
+      if ($item['expires_at'] === null || $item['expires_at'] > time()) {
+        $result[$key] = $item['value'];
+      }
+    }
+    return $result;
+  }
+
   /**
   * Returns cache statistics such as total entries, hits, misses, and expired items.
   * @return array Cache statistics.