Feat/updates

README.md

@@ -27,18 +27,31 @@ composer require myerscode/utilities-web
 use Myerscode\Utilities\Web\Utility;
 
 $web = new Utility('https://example.com');
+// or use the static factory
+$web = Utility::make('https://example.com');
 
 // Get content from a URL
 $content = $web->content()->content();
 
 // Get a DOM crawler for the page
 $dom = $web->content()->dom();
 
+// Decode JSON responses
+$data = $web->content()->json();
+
 // Ping a host
 $result = $web->ping()->ping();
+$alive = $web->ping()->isAlive();
+
+// Quick liveness check
+$web->isAlive();
 
 // Work with URLs
 $uri = $web->url();
+
+// Check response status
+$response = $web->response()->check(\Myerscode\Utilities\Web\Data\ResponseFrom::CURL);
+$response->isSuccessful(); // true for 2xx
 ```
 
 ## Available Utilities
@@ -52,6 +65,20 @@ Ping hosts and check latency.
 ### [URI Utility](docs/uri-utility.md)
 Parse, build and manipulate URLs.
 
+## Exception Handling
+
+All package exceptions extend `Myerscode\Utilities\Web\Exceptions\WebUtilityException`, which extends `RuntimeException`. This allows catching all package exceptions in one go:
+
+```php
+use Myerscode\Utilities\Web\Exceptions\WebUtilityException;
+
+try {
+    $content = $web->content()->content();
+} catch (WebUtilityException $e) {
+    // Handle any package exception
+}
+```
+
 ## License
 
 The MIT License (MIT). Please see [License File](LICENSE) for more information.

docs/content-utility.md

@@ -27,6 +27,40 @@ $dom = $utility->dom();
 $title = $dom->filterXPath('//title')->text();
 ```
 
+## json(): array
+
+Decode the response content as JSON.
+
+```php
+$data = $utility->json();
+```
+
+Throws `\JsonException` if the content is not valid JSON.
+
+## contentType(): ?string
+
+Get the Content-Type header from the response.
+
+```php
+$type = $utility->contentType(); // 'text/html; charset=utf-8'
+```
+
+## headers(): array
+
+Get all response headers.
+
+```php
+$headers = $utility->headers();
+```
+
+## statusCode(): int
+
+Get the HTTP status code.
+
+```php
+$code = $utility->statusCode(); // 200
+```
+
 ## response(): Response
 
 Get the full Response object containing status code, content and headers.
@@ -38,6 +72,33 @@ $content = $response->content();
 $headers = $response->headers();
 ```
 
+## post(array $data): Response
+
+Send a POST request with form data.
+
+```php
+$response = $utility->post(['name' => 'value']);
+$code = $response->code();
+```
+
+## withHeaders(array $headers): self
+
+Set custom request headers.
+
+```php
+$utility->withHeaders(['Authorization' => 'Bearer token']);
+$content = $utility->content();
+```
+
+## withTimeout(int $seconds): self
+
+Set the request timeout in seconds.
+
+```php
+$utility->withTimeout(60);
+$content = $utility->content();
+```
+
 ## url(): string
 
 Get the URL the utility is using.

docs/ping-utility.md

@@ -17,6 +17,38 @@ $result = $utility->ping();
 // ['alive' => true, 'latency' => 12.0]
 ```
 
+## isAlive(): bool
+
+Check if the host is alive.
+
+```php
+$utility->isAlive(); // true
+```
+
+## latency(): ?float
+
+Get the latency in milliseconds, or null if unreachable.
+
+```php
+$utility->latency(); // 12.0
+```
+
+## setTimeout(int $seconds): self
+
+Set the ping timeout in seconds.
+
+```php
+$utility->setTimeout(5)->ping();
+```
+
+## setTtl(int $ttl): self
+
+Set the TTL (time to live).
+
+```php
+$utility->setTtl(128)->ping();
+```
+
 ## url(): string
 
 Get the URL the utility is using.

docs/uri-utility.md

@@ -5,7 +5,7 @@ Parse, build and manipulate URLs.
 ```php
 use Myerscode\Utilities\Web\UriUtility;
 
-$utility = new UriUtility('https://example.com/path?foo=bar');
+$utility = new UriUtility('https://example.com/path?foo=bar#section');
 ```
 
 ## host(): string
@@ -56,6 +56,14 @@ Get the raw query string.
 $utility->query(); // 'foo=bar'
 ```
 
+## fragment(): string
+
+Get the URL fragment (the part after #).
+
+```php
+$utility->fragment(); // 'section'
+```
+
 ## getQueryParameters(): array
 
 Get query parameters as an associative array.
@@ -89,6 +97,97 @@ Replace the entire query string.
 $utility->setQuery(['new' => 'value']);
 ```
 
+## removeQueryParameter(string $key): self
+
+Remove a specific query parameter by key.
+
+```php
+$utility->removeQueryParameter('foo');
+```
+
+## hasQueryParameter(string $key): bool
+
+Check if a query parameter exists.
+
+```php
+$utility->hasQueryParameter('foo'); // true
+```
+
+## withScheme(string $scheme): self
+
+Set or replace the URL scheme.
+
+```php
+$utility->withScheme('http');
+```
+
+## withHost(string $host): self
+
+Set or replace the URL host.
+
+```php
+$utility->withHost('other.com');
+```
+
+## withPath(string $path): self
+
+Set or replace the URL path.
+
+```php
+$utility->withPath('/new/path');
+```
+
+## withPort(?int $port): self
+
+Set or replace the URL port. Pass `null` to remove.
+
+```php
+$utility->withPort(8080);
+```
+
+## withFragment(string $fragment): self
+
+Set or replace the URL fragment.
+
+```php
+$utility->withFragment('top');
+```
+
+## userInfo(): ?string
+
+Get the user info component of the URI, or null if not present.
+
+```php
+$utility->userInfo(); // null
+```
+
+## isValid(): bool
+
+Check if the URL is valid without making a request.
+
+```php
+$utility->isValid(); // true
+```
+
+## toArray(): array
+
+Get all parsed URL components as an associative array.
+
+```php
+$utility->toArray();
+// ['scheme' => 'https', 'host' => 'example.com', 'port' => 443, 'path' => '/path', 'query' => 'foo=bar', 'fragment' => 'section']
+```
+
+## equals(UriUtility $other): bool
+
+Compare two URIs for equality.
+
+```php
+$a = new UriUtility('https://example.com');
+$b = new UriUtility('https://example.com');
+$a->equals($b); // true
+```
+
 ## check(ResponseFrom $method): Response
 
 Check the URL response using curl, headers, or HTTP client.
@@ -105,5 +204,5 @@ $response->code(); // 200
 Get the full URL string.
 
 ```php
-$utility->value(); // 'https://example.com/path?foo=bar'
+$utility->value(); // 'https://example.com/path?foo=bar#section'
 ```