@aoxborrow/registrar-client 0.7.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aoxborrow/registrar-client",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "One consistent, fully-typed TypeScript interface to many domain registrar APIs (GoDaddy, Cloudflare, Namecheap, Spaceship, Dynadot, Porkbun, and more) behind a single pluggable multi-provider client",
   "author": {
     "name": "Aaron Oxborrow",
@@ -89,20 +89,20 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^26.2.0",
-    "@typescript-eslint/eslint-plugin": "^8.56.0",
-    "@typescript-eslint/parser": "^8.56.0",
+    "@types/node": "^26.6.2",
+    "@typescript-eslint/eslint-plugin": "^8.71.1",
+    "@typescript-eslint/parser": "^8.71.1",
     "@vitest/coverage-v8": "^4.1.11",
-    "dotenv": "^17.4.2",
-    "eslint": "^10.9.0",
+    "dotenv": "^18.0.1",
+    "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import-x": "^4.17.1",
-    "globals": "^17.11.0",
-    "prettier": "^3.6.2",
+    "globals": "^17.12.0",
+    "prettier": "^3.9.8",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.0",
+    "typescript-eslint": "^8.71.1",
     "vitest": "^4.1.11"
   },
   "dependencies": {

package/src/http.ts

@@ -31,6 +31,9 @@ export interface HttpClientConfig {
   // unset for APIs where the method means nothing: Namecheap and NameSilo send
   // writes as GET. Those mark their nested reads with `asRead` instead.
   safeMethods?: readonly string[];
+  // A provider-specific delay for HTTP 429 without a usable Retry-After.
+  // Otherwise the normal exponential backoff applies.
+  rateLimitFallbackSeconds?: number;
 }
 
 export const REST_SAFE_METHODS: readonly string[] = ['GET', 'HEAD'];
@@ -260,8 +263,10 @@ export class HttpClient {
       case 404:
         return new NotFoundError(message);
       case 429: {
-        const retryAfter = Number(response.headers.get('retry-after'));
-        return new RateLimitError(message, Number.isFinite(retryAfter) ? retryAfter : undefined);
+        const retryAfter =
+          parseRetryAfter(response.headers.get('retry-after')) ??
+          this.config.rateLimitFallbackSeconds;
+        return new RateLimitError(message, retryAfter);
       }
       default: {
         if (response.status >= 500) {
@@ -277,6 +282,25 @@ export class HttpClient {
   }
 }
 
+// RFC 9110 Retry-After is delay-seconds or an HTTP date. Absence must stay
+// undefined: Number(null) is zero and would bypass the configured backoff.
+function parseRetryAfter(value: string | null): number | undefined {
+  const text = value?.trim();
+  if (!text) return undefined;
+  if (/^\d+$/.test(text)) {
+    const seconds = Number(text);
+    return Number.isSafeInteger(seconds) ? seconds : undefined;
+  }
+  // Accept the HTTP-date formats from RFC 9110, not Date.parse's permissive
+  // numeric/calendar inputs. The obsolete asctime form has implicit UTC.
+  const zonedDate =
+    /^(?:[a-z]{3}, \d{2} [a-z]{3} \d{4}|[a-z]+, \d{2}-[a-z]{3}-\d{2}) \d{2}:\d{2}:\d{2} GMT$/i;
+  const asctimeDate = /^[a-z]{3} [a-z]{3} (?: \d|\d{2}) \d{2}:\d{2}:\d{2} \d{4}$/i;
+  if (!zonedDate.test(text) && !asctimeDate.test(text)) return undefined;
+  const date = Date.parse(asctimeDate.test(text) ? `${text} GMT` : text);
+  return Number.isFinite(date) ? Math.max(0, Math.ceil((date - Date.now()) / 1000)) : undefined;
+}
+
 // A retryable failure that leaves a write's result unknown: the request may
 // have reached the registrar. A rate limit is an explicit rejection, and a
 // connection error known to precede sending never reached it.

package/src/index.ts

@@ -27,6 +27,7 @@ export type { RegistrarFeature } from './features';
 
 // bundled providers
 export { CloudflareRegistrar } from './registrars/cloudflare';
+export { Domain101Registrar } from './registrars/domain101';
 export { DynadotRegistrar } from './registrars/dynadot';
 export { GandiRegistrar } from './registrars/gandi';
 export { GoDaddyRegistrar } from './registrars/godaddy';