chore: add pre-commit hooks for lint and update readme

Author: boutetnico

.githooks/pre-commit

@@ -0,0 +1,13 @@
+#!/bin/bash
+set -e
+
+echo "Running lint..."
+./vendor/bin/pint --test
+
+echo "Running static analysis..."
+./vendor/bin/phpstan analyse
+
+echo "Running tests..."
+./vendor/bin/pest --coverage --min=100
+
+echo "All checks passed."

README.md

@@ -155,8 +155,9 @@ try {
 | `NotFoundException` | 404 | No RDAP data found |
 | `RateLimitException` | 429 | Rate limit or quota exceeded |
 | `UpstreamException` | 502 | Upstream RDAP server failure |
+| `TemporarilyUnavailableException` | 503 | Domain data temporarily unavailable |
 
-All exceptions expose `statusCode`, `errorCode`, and `getMessage()`. `RateLimitException` also has `retryAfter` (int or null).
+All exceptions expose `statusCode`, `errorCode`, and `getMessage()`. `RateLimitException` and `TemporarilyUnavailableException` also have `retryAfter` (int or null).
 
 ## Nullable Fields
 
@@ -171,6 +172,14 @@ if ($domain->dates->expires !== null) {
 echo $domain->entities->registrant?->name;
 ```
 
+## Development
+
+Set up pre-commit hooks (runs lint + tests before each commit):
+
+```bash
+git config core.hooksPath .githooks
+```
+
 ## License
 
 MIT — see [LICENSE](LICENSE).