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

Author: boutetnico

.githooks/pre-commit

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -e
+
+echo "Running vet..."
+go vet ./...
+
+echo "Running format check..."
+UNFORMATTED=$(gofumpt -l . 2>/dev/null || gofmt -l .)
+if [ -n "$UNFORMATTED" ]; then
+  echo "Files need formatting:"
+  echo "$UNFORMATTED"
+  exit 1
+fi
+
+echo "Running tests..."
+go test -race ./...
+
+echo "Running build..."
+go build ./...
+
+echo "All checks passed."

README.md

@@ -144,6 +144,7 @@ if err != nil {
 | `NotFoundError` | 404 | No RDAP data found |
 | `RateLimitError` | 429 | Rate limit or quota exceeded |
 | `UpstreamError` | 502 | Upstream RDAP server failure |
+| `TemporarilyUnavailableError` | 503 | Domain data temporarily unavailable |
 
 All typed errors embed `*APIError` which provides `StatusCode`, `Code`, `Message`, and `RetryAfter` fields.
 
@@ -157,6 +158,14 @@ if domain.Dates.Expires != nil {
 }
 ```
 
+## Development
+
+Set up pre-commit hooks (runs lint + tests before each commit):
+
+```bash
+git config core.hooksPath .githooks
+```
+
 ## License
 
 MIT — see [LICENSE](LICENSE).