@aoxborrow/registrar-client 0.7.0 → 0.9.0

package/src/registrars/dynadot.ts

@@ -216,6 +216,9 @@ export class DynadotRegistrar extends BaseRegistrar {
           sandbox: 'https://api-sandbox.dynadot.com',
         }),
         headers: { Authorization: `Bearer ${credentials.apiKey}` },
+        // HTTP 429 can omit Retry-After. Avoid exhausting all attempts inside
+        // Dynadot's regular-tier minute window in that case.
+        rateLimitFallbackSeconds: 60,
       },
       options
     );

package/src/registrars/index.ts

@@ -5,6 +5,7 @@ import type {
   RegistrarOptions,
 } from '../types';
 import { CloudflareRegistrar } from './cloudflare';
+import { Domain101Registrar } from './domain101';
 import { DynadotRegistrar } from './dynadot';
 import { GandiRegistrar } from './gandi';
 import { GoDaddyRegistrar } from './godaddy';
@@ -17,16 +18,17 @@ import { SpaceshipRegistrar } from './spaceship';
 
 // the built-in registrar providers, keyed by id
 export const registrars = {
-  cloudflare: CloudflareRegistrar,
-  dynadot: DynadotRegistrar,
-  gandi: GandiRegistrar,
-  godaddy: GoDaddyRegistrar,
-  namebright: NameBrightRegistrar,
-  namecheap: NamecheapRegistrar,
-  namecom: NamecomRegistrar,
-  namesilo: NameSiloRegistrar,
-  porkbun: PorkbunRegistrar,
-  spaceship: SpaceshipRegistrar,
+  '101domain': Domain101Registrar,
+  'cloudflare': CloudflareRegistrar,
+  'dynadot': DynadotRegistrar,
+  'gandi': GandiRegistrar,
+  'godaddy': GoDaddyRegistrar,
+  'namebright': NameBrightRegistrar,
+  'namecheap': NamecheapRegistrar,
+  'namecom': NamecomRegistrar,
+  'namesilo': NameSiloRegistrar,
+  'porkbun': PorkbunRegistrar,
+  'spaceship': SpaceshipRegistrar,
 } satisfies Record<string, RegistrarConstructor>;
 
 // id of a built-in registrar

package/src/registrars/namecheap.ts

@@ -60,6 +60,7 @@ interface NcCheckEl {
   '@_Available'?: string;
   '@_IsPremiumName'?: string;
   '@_PremiumRegistrationPrice'?: string;
+  '@_PremiumRenewalPrice'?: string;
 }
 
 // a contact group in namecheap.domains.getContacts (children are text elements)
@@ -367,9 +368,10 @@ export class NamecheapRegistrar extends BaseRegistrar {
 
   /**
    * Availability via domains.check (batched at 50 per request, Namecheap's cap).
-   * The check response only carries a price for *premium* names
-   * (`PremiumRegistrationPrice`); regular registration pricing comes from
-   * `getPricing`, so `price` is set only for premium results.
+   * The check response only carries prices for *premium* names
+   * (`PremiumRegistrationPrice`, `PremiumRenewalPrice`); regular pricing comes
+   * from `getPricing`, so `price` and `renewalPrice` are set only for premium
+   * results.
    */
   override async checkAvailability(
     domainNames: string[],
@@ -385,12 +387,16 @@ export class NamecheapRegistrar extends BaseRegistrar {
       );
       for (const el of ensureArray(cr.DomainCheckResult)) {
         const premium = el['@_IsPremiumName'] === 'true';
-        const premiumPrice = premium ? Number(el['@_PremiumRegistrationPrice']) : NaN;
+        const premiumPrice = (attr: string | undefined) => {
+          const n = premium ? Number(attr) : NaN;
+          return Number.isFinite(n) && n > 0 ? n : undefined;
+        };
         results.push({
           domainName: el['@_Domain'] ?? '',
           available: el['@_Available'] === 'true',
           premium,
-          price: Number.isFinite(premiumPrice) && premiumPrice > 0 ? premiumPrice : undefined,
+          price: premiumPrice(el['@_PremiumRegistrationPrice']),
+          renewalPrice: premiumPrice(el['@_PremiumRenewalPrice']),
         });
       }
     }

package/src/registrars/namecom.ts

@@ -108,18 +108,14 @@ class NamecomHttpClient extends HttpClient {
       }),
       url
     );
-    if (error instanceof RateLimitError) {
-      const retryAfter = response.headers.get('retry-after');
-      const seconds = retryAfter == null ? NaN : Number(retryAfter);
-      const date = retryAfter == null ? NaN : Date.parse(retryAfter);
-      const reset = response.headers.get('x-ratelimit-reset');
-      error.retryAfter = Number.isFinite(seconds)
-        ? Math.max(0, seconds)
-        : Number.isFinite(date)
-          ? Math.max(0, (date - Date.now()) / 1000)
-          : reset != null && Number.isFinite(Number(reset))
-            ? Math.max(0, Number(reset) - Date.now() / 1000)
-            : undefined;
+    // The shared client has already read Retry-After. Without a usable one,
+    // fall back to X-RateLimit-Reset (Unix seconds); otherwise leave it unset
+    // so the configured backoff applies.
+    if (error instanceof RateLimitError && error.retryAfter === undefined) {
+      const reset = response.headers.get('x-ratelimit-reset')?.trim();
+      if (reset && /^\d+(?:\.\d+)?$/.test(reset)) {
+        error.retryAfter = Math.max(0, Math.ceil(Number(reset) - Date.now() / 1000));
+      }
     }
     return error;
   }

package/src/types.ts

@@ -80,6 +80,9 @@ export interface ConnectionResult {
 export interface OperationResult {
   success: boolean;
   message: string;
+  // Accepted by the registrar but still pending registry processing. Callers
+  // must not optimistically display the requested state as already active.
+  pending?: boolean;
   // Present only on a failed write whose request may have reached the
   // registrar (timed out, connection dropped mid-response, or a 5xx). The
   // change may or may not have been applied: re-read the domain before trying
@@ -194,6 +197,9 @@ export interface DomainAvailability {
   premium?: boolean;
   // registration price in major currency units (e.g. 11.99), when the API reports it
   price?: number;
+  // annual renewal price in major currency units, when the API reports one for
+  // this specific name (e.g. a premium name's renewal)
+  renewalPrice?: number;
   // ISO 4217 currency code, e.g. "USD"
   currency?: string;
   // the registration period the price covers, in years