Rename AsyncHttp to Http and enhance API documentation

- Rename AsyncHttp class to Http for cleaner API naming
- Add comprehensive PHPDoc annotations for all HTTP methods including PSR-7 interface methods
- Update all test files to use new Http class name
- Remove sample and stress test files
- Add missing use statements for HTTP interfaces and configuration classes
- Expand method documentation to include request builder, streaming, and PSR-7 methods

Author: rcalicdan

sample.php

@@ -6,6 +6,13 @@
 use Rcalicdan\FiberAsync\Http\Request;
 use Rcalicdan\FiberAsync\Http\Response;
 use Rcalicdan\FiberAsync\Http\StreamingResponse;
+use Rcalicdan\FiberAsync\Http\CacheConfig;
+use Rcalicdan\FiberAsync\Http\RetryConfig;
+use Rcalicdan\FiberAsync\Http\Stream;
+use Rcalicdan\FiberAsync\Http\Interfaces\MessageInterface;
+use Rcalicdan\FiberAsync\Http\Interfaces\RequestInterface;
+use Rcalicdan\FiberAsync\Http\Interfaces\StreamInterface;
+use Rcalicdan\FiberAsync\Http\Interfaces\UriInterface;
 use Rcalicdan\FiberAsync\Promise\Interfaces\CancellablePromiseInterface;
 use Rcalicdan\FiberAsync\Promise\Interfaces\PromiseInterface;
 
@@ -16,19 +23,63 @@
  * including GET, POST, streaming, and file downloads. It abstracts away the
  * underlying handler and event loop management for a more convenient API.
  *
+ * Direct HTTP methods from HttpHandler:
  * @method static PromiseInterface<Response> get(string $url, array<string, mixed> $query = []) Performs a GET request.
  * @method static PromiseInterface<Response> post(string $url, array<string, mixed> $data = []) Performs a POST request.
  * @method static PromiseInterface<Response> put(string $url, array<string, mixed> $data = []) Performs a PUT request.
  * @method static PromiseInterface<Response> delete(string $url) Performs a DELETE request.
  * @method static PromiseInterface<Response> fetch(string $url, array<int|string, mixed> $options = []) A flexible, fetch-like request method.
- * @method static PromiseInterface<StreamingResponse> stream(string $url, array<int|string, mixed> $options = [], ?callable $onChunk = null) Streams a response body.
+ * @method static CancellablePromiseInterface<StreamingResponse> stream(string $url, array<int|string, mixed> $options = [], ?callable $onChunk = null) Streams a response body.
  * @method static CancellablePromiseInterface<array{file: string, status: int, headers: array<mixed>}> download(string $url, string $destination, array<int|string, mixed> $options = []) Downloads a file.
+ *
+ * Request builder methods:
  * @method static Request cache(int $ttlSeconds = 3600, bool $respectServerHeaders = true) Start building a request with caching enabled.
+ * @method static Request cacheWith(CacheConfig $config) Start building a request with custom cache configuration.
  * @method static Request timeout(int $seconds) Start building a request with timeout.
+ * @method static Request connectTimeout(int $seconds) Start building a request with connection timeout.
  * @method static Request headers(array<string, string> $headers) Start building a request with headers.
+ * @method static Request header(string $name, string $value) Start building a request with a single header.
+ * @method static Request contentType(string $type) Start building a request with Content-Type header.
+ * @method static Request accept(string $type) Start building a request with Accept header.
  * @method static Request bearerToken(string $token) Start building a request with bearer token.
  * @method static Request basicAuth(string $username, string $password) Start building a request with basic auth.
  * @method static Request retry(int $maxRetries = 3, float $baseDelay = 1.0, float $backoffMultiplier = 2.0) Start building a request with retry logic.
+ * @method static Request retryWith(RetryConfig $config) Start building a request with custom retry configuration.
+ * @method static Request noRetry() Start building a request with retries disabled.
+ * @method static Request redirects(bool $follow = true, int $max = 5) Start building a request with redirect configuration.
+ * @method static Request verifySSL(bool $verify = true) Start building a request with SSL verification configuration.
+ * @method static Request userAgent(string $userAgent) Start building a request with custom User-Agent.
+ * @method static Request body(string $content) Start building a request with string body.
+ * @method static Request json(array<string, mixed> $data) Start building a request with JSON body.
+ * @method static Request form(array<string, mixed> $data) Start building a request with form data.
+ * @method static Request multipart(array<string, mixed> $data) Start building a request with multipart data.
+ *
+ * PSR-7 Message interface methods (immutable with* methods):
+ * @method static MessageInterface withProtocolVersion(string $version) Return an instance with the specified HTTP protocol version.
+ * @method static array<string, string[]> getHeaders() Retrieves all message header values.
+ * @method static bool hasHeader(string $name) Checks if a header exists by the given case-insensitive name.
+ * @method static string[] getHeader(string $name) Retrieves a message header value by the given case-insensitive name.
+ * @method static string getHeaderLine(string $name) Retrieves a comma-separated string of the values for a single header.
+ * @method static MessageInterface withHeader(string $name, string|string[] $value) Return an instance with the provided value replacing the specified header.
+ * @method static MessageInterface withAddedHeader(string $name, string|string[] $value) Return an instance with the specified header appended with the given value.
+ * @method static MessageInterface withoutHeader(string $name) Return an instance without the specified header.
+ * @method static StreamInterface getBody() Gets the body of the message.
+ * @method static MessageInterface withBody(StreamInterface $body) Return an instance with the specified message body.
+ * @method static string getProtocolVersion() Retrieves the HTTP protocol version as a string.
+ *
+ * PSR-7 Request interface methods:
+ * @method static string getRequestTarget() Retrieves the message's request target.
+ * @method static RequestInterface withRequestTarget(string $requestTarget) Return an instance with the specific request-target.
+ * @method static string getMethod() Retrieves the HTTP method of the request.
+ * @method static RequestInterface withMethod(string $method) Return an instance with the provided HTTP method.
+ * @method static UriInterface getUri() Retrieves the URI instance.
+ * @method static RequestInterface withUri(UriInterface $uri, bool $preserveHost = false) Returns an instance with the provided URI.
+ *
+ * Request streaming methods:
+ * @method static CancellablePromiseInterface<StreamingResponse> streamPost(string $url, mixed $body = null, ?callable $onChunk = null) Streams the response body of a POST request.
+ *
+ * Request execution methods:
+ * @method static PromiseInterface<Response> send(string $method, string $url) Dispatches the configured request.
  */
 class Http
 {
@@ -79,7 +130,7 @@ public static function setInstance(HttpHandler $handler): void
      * Magic method to handle dynamic static calls.
      * 
      * This enables both direct HTTP methods (get, post, etc.) and request builder methods
-     * (cache, timeout, headers, etc.) to be called directly on AsyncHttp.
+     * (cache, timeout, headers, etc.) to be called directly on Http.
      *
      * @param  string  $method  The method name.
      * @param  array<mixed>  $arguments  The arguments to pass to the method.
@@ -89,7 +140,7 @@ public static function __callStatic(string $method, array $arguments)
     {
         $handler = self::getInstance();
 
-        $directMethods = ['get', 'post', 'put', 'delete', 'fetch', 'stream', 'download'];
+        $directMethods = ['get', 'post', 'put', 'delete', 'fetch', 'stream', 'download', 'createStream', 'createStreamFromFile'];
 
         if (in_array($method, $directMethods)) {
             return $handler->{$method}(...$arguments);
@@ -106,4 +157,4 @@ public static function __callStatic(string $method, array $arguments)
 
         throw new \BadMethodCallException("Method {$method} does not exist on " . static::class);
     }
-}
+}

sample_http.php

@@ -21,7 +21,7 @@
 /**
  * Core handler for creating and dispatching asynchronous HTTP requests.
  *
- * This class acts as the workhorse for the AsyncHttp Api, translating high-level
+ * This class acts as the workhorse for the Http Api, translating high-level
  * requests into low-level operations managed by the event loop.
  */
 class HttpHandler