@aoxborrow/registrar-client 0.1.0 → 0.3.0

package/dist/index.d.cts

@@ -181,6 +181,7 @@ interface Registrar {
     readonly name: string;
     readonly environment: RegistrarEnvironment;
     readonly features: readonly RegistrarFeature[];
+    readonly requiresNameserversFetch: boolean;
     supports(feature: RegistrarFeature): boolean;
     testConnection(opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
@@ -211,6 +212,7 @@ interface Registrar {
 interface RegistrarConstructor {
     new (credentials: RegistrarCredentials, options?: RegistrarOptions): Registrar;
     readonly displayName: string;
+    readonly website: string;
     readonly configFields: ConfigField[];
     readonly helpText: string;
     readonly supportsSandbox: boolean;
@@ -360,6 +362,7 @@ declare abstract class BaseRegistrar implements Registrar {
     static get features(): readonly RegistrarFeature[];
     get features(): readonly RegistrarFeature[];
     supports(feature: RegistrarFeature): boolean;
+    readonly requiresNameserversFetch: boolean;
     constructor(credentials: RegistrarCredentials, httpConfig: Omit<HttpClientConfig, 'options'>, options?: RegistrarOptions);
     testConnection(_opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(_opts?: ListDomainsOptions): Promise<Domain[]>;
@@ -392,6 +395,7 @@ declare abstract class BaseRegistrar implements Registrar {
 declare class CloudflareRegistrar extends BaseRegistrar {
     readonly name = "cloudflare";
     static readonly displayName = "Cloudflare";
+    static readonly website = "cloudflare.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = false;
@@ -435,6 +439,7 @@ declare class CloudflareRegistrar extends BaseRegistrar {
 declare class DynadotRegistrar extends BaseRegistrar {
     readonly name = "dynadot";
     static readonly displayName = "Dynadot";
+    static readonly website = "dynadot.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -447,6 +452,7 @@ declare class DynadotRegistrar extends BaseRegistrar {
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
     private domainInfo;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     getContacts(domainName: string, opts?: RequestOptions): Promise<ContactSet>;
     getDnsRecords(domainName: string, opts?: RequestOptions): Promise<DnsRecord[]>;
@@ -477,6 +483,7 @@ declare class DynadotRegistrar extends BaseRegistrar {
 declare class GandiRegistrar extends BaseRegistrar {
     readonly name = "gandi";
     static readonly displayName = "Gandi.net";
+    static readonly website = "gandi.net";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -514,6 +521,7 @@ declare class GandiRegistrar extends BaseRegistrar {
 declare class GoDaddyRegistrar extends BaseRegistrar {
     readonly name = "godaddy";
     static readonly displayName = "GoDaddy";
+    static readonly website = "godaddy.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -527,6 +535,7 @@ declare class GoDaddyRegistrar extends BaseRegistrar {
     private listDomainsV3;
     private listDomainsV1;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     checkAvailability(domainNames: string[], opts?: RequestOptions): Promise<DomainAvailability[]>;
     getPricing(tldOrDomain: string, opts?: RequestOptions): Promise<TldPricing>;
@@ -560,6 +569,7 @@ declare class GoDaddyRegistrar extends BaseRegistrar {
 declare class NameBrightRegistrar extends BaseRegistrar {
     readonly name = "namebright";
     static readonly displayName = "NameBright";
+    static readonly website = "namebright.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = false;
@@ -594,6 +604,7 @@ declare class NameBrightRegistrar extends BaseRegistrar {
 declare class NamecheapRegistrar extends BaseRegistrar {
     readonly name = "namecheap";
     static readonly displayName = "Namecheap";
+    static readonly website = "namecheap.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -630,6 +641,7 @@ declare class NamecheapRegistrar extends BaseRegistrar {
 declare class NameSiloRegistrar extends BaseRegistrar {
     readonly name = "namesilo";
     static readonly displayName = "NameSilo";
+    static readonly website = "namesilo.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -639,6 +651,7 @@ declare class NameSiloRegistrar extends BaseRegistrar {
     testConnection(opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     getContacts(domainName: string, opts?: RequestOptions): Promise<ContactSet>;
     getDnsRecords(domainName: string, opts?: RequestOptions): Promise<DnsRecord[]>;
@@ -666,6 +679,7 @@ declare class NameSiloRegistrar extends BaseRegistrar {
 declare class PorkbunRegistrar extends BaseRegistrar {
     readonly name = "porkbun";
     static readonly displayName = "Porkbun";
+    static readonly website = "porkbun.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -698,6 +712,7 @@ declare class PorkbunRegistrar extends BaseRegistrar {
 declare class SpaceshipRegistrar extends BaseRegistrar {
     readonly name = "spaceship";
     static readonly displayName = "Spaceship";
+    static readonly website = "spaceship.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = false;
@@ -706,6 +721,7 @@ declare class SpaceshipRegistrar extends BaseRegistrar {
     testConnection(opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     getAuthCode(domainName: string, opts?: RequestOptions): Promise<string>;
     checkAvailability(domainNames: string[], opts?: RequestOptions): Promise<DomainAvailability[]>;

package/dist/index.d.ts

@@ -181,6 +181,7 @@ interface Registrar {
     readonly name: string;
     readonly environment: RegistrarEnvironment;
     readonly features: readonly RegistrarFeature[];
+    readonly requiresNameserversFetch: boolean;
     supports(feature: RegistrarFeature): boolean;
     testConnection(opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
@@ -211,6 +212,7 @@ interface Registrar {
 interface RegistrarConstructor {
     new (credentials: RegistrarCredentials, options?: RegistrarOptions): Registrar;
     readonly displayName: string;
+    readonly website: string;
     readonly configFields: ConfigField[];
     readonly helpText: string;
     readonly supportsSandbox: boolean;
@@ -360,6 +362,7 @@ declare abstract class BaseRegistrar implements Registrar {
     static get features(): readonly RegistrarFeature[];
     get features(): readonly RegistrarFeature[];
     supports(feature: RegistrarFeature): boolean;
+    readonly requiresNameserversFetch: boolean;
     constructor(credentials: RegistrarCredentials, httpConfig: Omit<HttpClientConfig, 'options'>, options?: RegistrarOptions);
     testConnection(_opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(_opts?: ListDomainsOptions): Promise<Domain[]>;
@@ -392,6 +395,7 @@ declare abstract class BaseRegistrar implements Registrar {
 declare class CloudflareRegistrar extends BaseRegistrar {
     readonly name = "cloudflare";
     static readonly displayName = "Cloudflare";
+    static readonly website = "cloudflare.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = false;
@@ -435,6 +439,7 @@ declare class CloudflareRegistrar extends BaseRegistrar {
 declare class DynadotRegistrar extends BaseRegistrar {
     readonly name = "dynadot";
     static readonly displayName = "Dynadot";
+    static readonly website = "dynadot.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -447,6 +452,7 @@ declare class DynadotRegistrar extends BaseRegistrar {
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
     private domainInfo;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     getContacts(domainName: string, opts?: RequestOptions): Promise<ContactSet>;
     getDnsRecords(domainName: string, opts?: RequestOptions): Promise<DnsRecord[]>;
@@ -477,6 +483,7 @@ declare class DynadotRegistrar extends BaseRegistrar {
 declare class GandiRegistrar extends BaseRegistrar {
     readonly name = "gandi";
     static readonly displayName = "Gandi.net";
+    static readonly website = "gandi.net";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -514,6 +521,7 @@ declare class GandiRegistrar extends BaseRegistrar {
 declare class GoDaddyRegistrar extends BaseRegistrar {
     readonly name = "godaddy";
     static readonly displayName = "GoDaddy";
+    static readonly website = "godaddy.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -527,6 +535,7 @@ declare class GoDaddyRegistrar extends BaseRegistrar {
     private listDomainsV3;
     private listDomainsV1;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     checkAvailability(domainNames: string[], opts?: RequestOptions): Promise<DomainAvailability[]>;
     getPricing(tldOrDomain: string, opts?: RequestOptions): Promise<TldPricing>;
@@ -560,6 +569,7 @@ declare class GoDaddyRegistrar extends BaseRegistrar {
 declare class NameBrightRegistrar extends BaseRegistrar {
     readonly name = "namebright";
     static readonly displayName = "NameBright";
+    static readonly website = "namebright.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = false;
@@ -594,6 +604,7 @@ declare class NameBrightRegistrar extends BaseRegistrar {
 declare class NamecheapRegistrar extends BaseRegistrar {
     readonly name = "namecheap";
     static readonly displayName = "Namecheap";
+    static readonly website = "namecheap.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -630,6 +641,7 @@ declare class NamecheapRegistrar extends BaseRegistrar {
 declare class NameSiloRegistrar extends BaseRegistrar {
     readonly name = "namesilo";
     static readonly displayName = "NameSilo";
+    static readonly website = "namesilo.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -639,6 +651,7 @@ declare class NameSiloRegistrar extends BaseRegistrar {
     testConnection(opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     getContacts(domainName: string, opts?: RequestOptions): Promise<ContactSet>;
     getDnsRecords(domainName: string, opts?: RequestOptions): Promise<DnsRecord[]>;
@@ -666,6 +679,7 @@ declare class NameSiloRegistrar extends BaseRegistrar {
 declare class PorkbunRegistrar extends BaseRegistrar {
     readonly name = "porkbun";
     static readonly displayName = "Porkbun";
+    static readonly website = "porkbun.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = true;
@@ -698,6 +712,7 @@ declare class PorkbunRegistrar extends BaseRegistrar {
 declare class SpaceshipRegistrar extends BaseRegistrar {
     readonly name = "spaceship";
     static readonly displayName = "Spaceship";
+    static readonly website = "spaceship.com";
     static readonly helpText: string;
     static readonly configFields: ConfigField[];
     static readonly supportsSandbox = false;
@@ -706,6 +721,7 @@ declare class SpaceshipRegistrar extends BaseRegistrar {
     testConnection(opts?: RequestOptions): Promise<ConnectionResult>;
     listDomains(opts?: ListDomainsOptions): Promise<Domain[]>;
     getDomain(domainName: string, opts?: RequestOptions): Promise<Domain>;
+    readonly requiresNameserversFetch = false;
     getNameservers(domainName: string, opts?: RequestOptions): Promise<string[]>;
     getAuthCode(domainName: string, opts?: RequestOptions): Promise<string>;
     checkAvailability(domainNames: string[], opts?: RequestOptions): Promise<DomainAvailability[]>;

package/dist/index.js

@@ -256,7 +256,7 @@ var RegistrarClient = class {
         try {
           const detail = await this.provider.getDomain(name, opts);
           let merged = { ...domains[index], ...detail };
-          if (merged.nameservers.length === 0) {
+          if (merged.nameservers.length === 0 && this.provider.requiresNameserversFetch) {
             try {
               const nameservers = normalizeNameservers(
                 await this.provider.getNameservers(name, opts)
@@ -644,6 +644,11 @@ var BaseRegistrar = class {
   supports(feature) {
     return this.features.includes(feature);
   }
+  // See Registrar.requiresNameserversFetch. Defaults true, so a provider
+  // whose getNameservers hits a real endpoint keeps the enrichment fallback
+  // without opting in; the providers whose getNameservers just re-reads getDomain
+  // override this to false to drop the redundant call.
+  requiresNameserversFetch = true;
   constructor(credentials, httpConfig, options) {
     const { environment = "production", ...clientOptions } = options ?? {};
     this.credentials = credentials;
@@ -741,6 +746,7 @@ var BaseRegistrar = class {
 var CloudflareRegistrar = class _CloudflareRegistrar extends BaseRegistrar {
   name = "cloudflare";
   static displayName = "Cloudflare";
+  static website = "cloudflare.com";
   static helpText = 'Create an API token in your Cloudflare dashboard under My Profile > API Tokens. The token needs "Account.Registrar" read/write permissions. Find your Account ID in the URL or on the Overview page of any zone.';
   static configFields = [
     { name: "apiToken", label: "API Token", type: "password", required: true },
@@ -1597,6 +1603,7 @@ var SUPPORTED_DNS_TYPES = /* @__PURE__ */ new Set(["A", "AAAA", "CNAME", "MX", "
 var DynadotRegistrar = class extends BaseRegistrar {
   name = "dynadot";
   static displayName = "Dynadot";
+  static website = "dynadot.com";
   static helpText = "Under Tools > API in your Dynadot account, generate an API Key and API Secret. The account must be unlocked with API access enabled. The key identifies you; the secret signs requests (X-Signature) and is never sent directly.";
   static configFields = [
     { name: "apiKey", label: "API Key", type: "password", required: true },
@@ -1712,6 +1719,9 @@ ${bodyStr}`;
     if (!data.domain_info) throw new NotFoundError(`Dynadot: domain '${domainName}' not found`);
     return data.domain_info;
   }
+  // getNameservers re-reads getDomain (domain_info carries NS inline; no separate
+  // endpoint), so listing enrichment gains nothing from the fallback — skip it.
+  requiresNameserversFetch = false;
   async getNameservers(domainName, opts) {
     const domain = await this.getDomain(domainName, opts);
     return domain.nameservers;
@@ -2344,6 +2354,7 @@ var GANDI_TYPE_TO_FORWARD = {
 var GandiRegistrar = class extends BaseRegistrar {
   name = "gandi";
   static displayName = "Gandi.net";
+  static website = "gandi.net";
   static helpText = "Generate a Personal Access Token (PAT) in your Gandi account under Account Settings > Security. The token needs permission to manage domains. (Gandi has deprecated the legacy API Key; use a PAT.)";
   static configFields = [
     { name: "apiKey", label: "Personal Access Token", type: "password", required: true }
@@ -3030,6 +3041,7 @@ var PRICE_MICRO_UNITS = 1e6;
 var GoDaddyRegistrar = class _GoDaddyRegistrar extends BaseRegistrar {
   name = "godaddy";
   static displayName = "GoDaddy";
+  static website = "godaddy.com";
   static helpText = 'Authenticate one of two ways. For production, create a Personal Access Token (PAT) at https://developer.godaddy.com and pass it as `apiToken` \u2014 this enables the modern v3 API. For sandbox testing, create OTE (test environment) keys and pass `apiKey` + `apiSecret` with { environment: "sandbox" }; OTE only exposes the legacy v1 API. The sso-key (API Key/Secret) scheme is deprecated by GoDaddy in 2026. Domain forwarding uses the v2 customer-scoped API \u2014 set `customerId` to your GoDaddy customer UUID, or to your numeric shopper/account ID (which the client resolves to the UUID via an sso-key-authenticated lookup).';
   static configFields = [
     { name: "apiToken", label: "API Token (PAT)", type: "password", required: false },
@@ -3153,6 +3165,9 @@ var GoDaddyRegistrar = class _GoDaddyRegistrar extends BaseRegistrar {
     });
     return this.toDomain(d);
   }
+  // getNameservers re-reads getDomain (GoDaddy has no dedicated NS endpoint), so
+  // listing enrichment gains nothing from the fallback — skip it.
+  requiresNameserversFetch = false;
   async getNameservers(domainName, opts) {
     const domain = await this.getDomain(domainName, opts);
     return domain.nameservers;
@@ -3894,6 +3909,7 @@ var TOKEN_URL = "https://api.namebright.com/auth/token";
 var NameBrightRegistrar = class extends BaseRegistrar {
   name = "namebright";
   static displayName = "NameBright";
+  static website = "namebright.com";
   static helpText = 'API access is not enabled by default \u2014 you must request it from NameBright (contact support / your account manager) before the API Management page is available. Once enabled, create an API Application under my.namebright.com > My Account > API Management. The Client ID is "<accountName>:<applicationName>"; NameBright issues the Client Secret. Note the application also enforces an IP whitelist.';
   static configFields = [
     { name: "clientId", label: "Client ID", type: "text", required: true },
@@ -4384,6 +4400,7 @@ var NC_CONTACT_ROLES = [
 var NamecheapRegistrar = class extends BaseRegistrar {
   name = "namecheap";
   static displayName = "Namecheap";
+  static website = "namecheap.com";
   static helpText = "Enable API access in your Namecheap account under Profile > Tools > API Access, generate an API key, and whitelist your request IP(s) in the API settings. Provide the whitelisted IP as the Client IP field.";
   static configFields = [
     { name: "username", label: "Username", type: "text", required: true },
@@ -4941,6 +4958,7 @@ function toNcContactParams(prefix, c) {
 var NameSiloRegistrar = class extends BaseRegistrar {
   name = "namesilo";
   static displayName = "NameSilo";
+  static website = "namesilo.com";
   static helpText = 'Generate an API key in your NameSilo account under Account Options > API Manager. You can optionally restrict the key to specific IP addresses there. For sandbox testing, use { environment: "sandbox" } (OTE host ote.namesilo.com) \u2014 OTE credentials are not self-service; you must contact NameSilo support to be issued them.';
   static configFields = [
     { name: "apiKey", label: "API Key", type: "password", required: true }
@@ -5051,6 +5069,9 @@ var NameSiloRegistrar = class extends BaseRegistrar {
       nameservers: extractNsHosts(r.nameservers)
     });
   }
+  // getNameservers re-reads getDomain (getDomainInfo carries NS; no separate
+  // endpoint), so listing enrichment gains nothing from the fallback — skip it.
+  requiresNameserversFetch = false;
   async getNameservers(domainName, opts) {
     const domain = await this.getDomain(domainName, opts);
     return domain.nameservers;
@@ -5622,6 +5643,7 @@ var PB_TYPE_TO_FORWARD = {
 var PorkbunRegistrar = class extends BaseRegistrar {
   name = "porkbun";
   static displayName = "Porkbun";
+  static website = "porkbun.com";
   static helpText = 'Create an API key and secret in your Porkbun account under Account > API Access, then enable "API Access" on each domain you want to manage (per-domain toggle in the domain details). For testing, use a sandbox key (prefixed "pk1_sb_") with { environment: "sandbox" } \u2014 it hits the same base URL but an isolated test environment with $1,000 of fake credit and no real charges (top up or reset via POST /sandbox/topup and POST /sandbox/reset).';
   static configFields = [
     { name: "apiKey", label: "API Key", type: "password", required: true },
@@ -6228,6 +6250,7 @@ var WRITABLE_DNS_TYPES = /* @__PURE__ */ new Set(["A", "AAAA", "CNAME", "NS", "T
 var SpaceshipRegistrar = class extends BaseRegistrar {
   name = "spaceship";
   static displayName = "Spaceship";
+  static website = "spaceship.com";
   static helpText = 'Generate your API key and secret in the API Manager at Spaceship using the "New API key" button. The API requires both X-API-Key and X-API-Secret headers.';
   static configFields = [
     { name: "apiKey", label: "API Key", type: "password", required: true },
@@ -6290,6 +6313,9 @@ var SpaceshipRegistrar = class extends BaseRegistrar {
   async getDomain(domainName, opts) {
     return this.toDomain(await this.getRaw(domainName, opts));
   }
+  // getNameservers reads the same getRaw payload as getDomain (no dedicated NS
+  // endpoint), so listing enrichment gains nothing from the fallback — skip it.
+  requiresNameserversFetch = false;
   async getNameservers(domainName, opts) {
     const d = await this.getRaw(domainName, opts);
     return d.nameservers?.hosts ?? [];