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

Author: boutetnico

.githooks/pre-commit

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -e
+
+echo "Running lint..."
+npm run lint
+
+echo "Running format check..."
+npm run format:check
+
+echo "Running typecheck..."
+npm run typecheck
+
+echo "Running tests..."
+npm test
+
+echo "All checks passed."

README.md

@@ -100,14 +100,15 @@ try {
 
 All exceptions inherit from `RdapApiError` and include `statusCode`, `error`, and `message` properties.
 
-| Exception                   | HTTP Status | When                         |
-| --------------------------- | ----------- | ---------------------------- |
-| `ValidationError`           | 400         | Invalid input format         |
-| `AuthenticationError`       | 401         | Missing or invalid API key   |
-| `SubscriptionRequiredError` | 403         | No active subscription       |
-| `NotFoundError`             | 404         | No RDAP data found           |
-| `RateLimitError`            | 429         | Rate limit or quota exceeded |
-| `UpstreamError`             | 502         | Upstream RDAP server error   |
+| Exception                     | HTTP Status | When                                |
+| ----------------------------- | ----------- | ----------------------------------- |
+| `ValidationError`             | 400         | Invalid input format                |
+| `AuthenticationError`         | 401         | Missing or invalid API key          |
+| `SubscriptionRequiredError`   | 403         | No active subscription              |
+| `NotFoundError`               | 404         | No RDAP data found                  |
+| `RateLimitError`              | 429         | Rate limit or quota exceeded        |
+| `UpstreamError`               | 502         | Upstream RDAP server error          |
+| `TemporarilyUnavailableError` | 503         | Domain data temporarily unavailable |
 
 ## Configuration
 
@@ -138,6 +139,14 @@ import type { DomainResponse, IpResponse, AsnResponse } from "rdapapi";
 - [OpenAPI Spec](https://rdapapi.io/openapi.yaml)
 - [Pricing](https://rdapapi.io/pricing)
 
+## Development
+
+Set up pre-commit hooks (runs lint + tests before each commit):
+
+```bash
+git config core.hooksPath .githooks
+```
+
 ## License
 
 MIT

src/client.ts

@@ -104,7 +104,11 @@ export class RdapClient {
 
     if (response.status === 503) {
       const retryAfter = response.headers.get("Retry-After");
-      throw new TemporarilyUnavailableError(message, error, retryAfter ? parseInt(retryAfter, 10) : null);
+      throw new TemporarilyUnavailableError(
+        message,
+        error,
+        retryAfter ? parseInt(retryAfter, 10) : null,
+      );
     }
 
     const ErrorClass = ERROR_MAP[response.status];

tests/client.test.ts

@@ -338,7 +338,10 @@ describe("error handling", () => {
   it("throws TemporarilyUnavailableError on 503 with retryAfter", async () => {
     const client = new RdapClient("test-key", { baseUrl: BASE_URL });
     globalThis.fetch = mockFetch(
-      { error: "temporarily_unavailable", message: "Data for this domain is temporarily unavailable." },
+      {
+        error: "temporarily_unavailable",
+        message: "Data for this domain is temporarily unavailable.",
+      },
       503,
       { "Retry-After": "300" },
     );
@@ -356,7 +359,10 @@ describe("error handling", () => {
   it("throws TemporarilyUnavailableError with null retryAfter when header missing", async () => {
     const client = new RdapClient("test-key", { baseUrl: BASE_URL });
     globalThis.fetch = mockFetch(
-      { error: "temporarily_unavailable", message: "Data for this domain is temporarily unavailable." },
+      {
+        error: "temporarily_unavailable",
+        message: "Data for this domain is temporarily unavailable.",
+      },
       503,
     );
 

tests/errors.test.ts

@@ -85,7 +85,11 @@ describe("RateLimitError", () => {
 
 describe("TemporarilyUnavailableError", () => {
   it("has status 503, retryAfter, and correct prototype chain", () => {
-    const err = new TemporarilyUnavailableError("Temporarily unavailable", "temporarily_unavailable", 300);
+    const err = new TemporarilyUnavailableError(
+      "Temporarily unavailable",
+      "temporarily_unavailable",
+      300,
+    );
     expect(err.statusCode).toBe(503);
     expect(err.retryAfter).toBe(300);
     expect(err.name).toBe("TemporarilyUnavailableError");
@@ -94,7 +98,11 @@ describe("TemporarilyUnavailableError", () => {
   });
 
   it("handles null retryAfter", () => {
-    const err = new TemporarilyUnavailableError("Temporarily unavailable", "temporarily_unavailable", null);
+    const err = new TemporarilyUnavailableError(
+      "Temporarily unavailable",
+      "temporarily_unavailable",
+      null,
+    );
     expect(err.retryAfter).toBeNull();
   });
 });