@push.rocks/smartnetwork 4.8.0 → 4.10.0

package/ts/smartnetwork.classes.domainintelligence.ts

@@ -70,8 +70,6 @@ export interface IDomainIntelligenceOptions {
   dnsClient?: TSmartdnsClient;
 }
 
-// IANA bootstrap for domain RDAP
-const IANA_BOOTSTRAP_DNS_URL = 'https://data.iana.org/rdap/dns.json';
 const DEFAULT_TIMEOUT = 5000;
 
 /**
@@ -103,16 +101,16 @@ function emptyResult(domain: string | null = null): IDomainIntelligenceResult {
 }
 
 /**
- * DomainIntelligence performs RDAP lookups for domain names using the
- * IANA DNS bootstrap to discover the correct registry RDAP endpoint per TLD.
+ * DomainIntelligence performs RDAP lookups for domain names via
+ * @push.rocks/smartwhois, which resolves the correct registry RDAP endpoint
+ * per TLD through the IANA DNS bootstrap.
  */
 export class DomainIntelligence {
   private readonly logger = getLogger();
   private readonly timeout: number;
 
-  // Bootstrap cache: tld (lowercased) -> RDAP base URL (without trailing slash)
-  private bootstrapEntries: Map<string, string> | null = null;
-  private bootstrapPromise: Promise<void> | null = null;
+  // RDAP client from smartwhois (owns bootstrap caching and registry failover)
+  private readonly rdapClient: plugins.smartwhois.RdapClient;
 
   // Optional injected smartdns client (shared by SmartNetwork)
   private readonly sharedDnsClient: TSmartdnsClient | null;
@@ -120,6 +118,11 @@ export class DomainIntelligence {
   constructor(options?: IDomainIntelligenceOptions) {
     this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
     this.sharedDnsClient = options?.dnsClient ?? null;
+    this.rdapClient = new plugins.smartwhois.RdapClient({
+      requestTimeoutMs: this.timeout,
+      totalTimeoutMs: this.timeout,
+      userAgent: '@push.rocks/smartnetwork',
+    });
   }
 
   /**
@@ -169,26 +172,49 @@ export class DomainIntelligence {
     return result;
   }
 
-  // ─── RDAP Layer (existing logic, wrapped) ───────────────────────────
+  // ─── RDAP Layer (delegated to @push.rocks/smartwhois) ───────────────
 
   /**
-   * Run the full RDAP lookup flow for a pre-normalized domain: extract TLD,
-   * load bootstrap, match registry, query, and parse. Returns the parsed
-   * RDAP fields (as a full IDomainIntelligenceResult) or null if any step
-   * fails or the TLD has no RDAP support.
+   * Run the full RDAP lookup flow for a pre-normalized domain via the
+   * smartwhois RdapClient. Returns the parsed RDAP fields (as a full
+   * IDomainIntelligenceResult) or null if any step fails, the TLD has no
+   * RDAP support, or the registry reports the domain as not registered.
    */
   private async queryRdapLayer(domain: string): Promise<IDomainIntelligenceResult | null> {
-    const tld = this.extractTld(domain);
-    if (!tld) return null;
-
-    await this.ensureBootstrap();
-    const baseUrl = this.matchTld(tld);
-    if (!baseUrl) return null;
-
-    const rdapData = await this.queryRdap(domain, baseUrl);
-    if (!rdapData) return null;
+    try {
+      const rdapRecord = await this.rdapClient.lookupDomain(domain);
+      if (!rdapRecord || !rdapRecord.isRegistered) return null;
+      return this.mapRdapRecord(domain, rdapRecord);
+    } catch (err: any) {
+      this.logger.debug?.(`RDAP query failed for ${domain}: ${err.message}`);
+      return null;
+    }
+  }
 
-    return this.parseRdapResponse(domain, rdapData);
+  /**
+   * Map a smartwhois RDAP domain record onto the IDomainIntelligenceResult
+   * shape (RDAP fields only; DNS enrichment fields stay null here).
+   */
+  private mapRdapRecord(
+    domain: string,
+    record: plugins.smartwhois.IRdapDomainRecord,
+  ): IDomainIntelligenceResult {
+    const result = emptyResult(domain);
+    result.handle = record.handle ?? null;
+    result.status = record.statuses && record.statuses.length > 0 ? record.statuses : null;
+    result.registrationDate = record.createdDate ?? null;
+    result.expirationDate = record.expiryDate ?? null;
+    result.lastChangedDate = record.updatedDate ?? null;
+    result.registrarName = record.registrar ?? null;
+    result.registrarIanaId = record.registrarIanaId ?? null;
+    result.registrantOrg = record.registrantOrg ?? null;
+    result.registrantCountry = record.registrantCountry ?? null;
+    result.abuseEmail = record.abuseEmail ?? null;
+    result.abusePhone = record.abusePhone ?? null;
+    result.nameservers =
+      record.nameservers && record.nameservers.length > 0 ? record.nameservers : null;
+    result.dnssec = record.dnssec ?? null;
+    return result;
   }
 
   // ─── Normalization & TLD extraction ─────────────────────────────────
@@ -217,244 +243,6 @@ export class DomainIntelligence {
     return ascii;
   }
 
-  /**
-   * Extract the TLD as the last dot-separated label.
-   */
-  private extractTld(domain: string): string | null {
-    const idx = domain.lastIndexOf('.');
-    if (idx < 0 || idx === domain.length - 1) return null;
-    return domain.slice(idx + 1);
-  }
-
-  // ─── Bootstrap Subsystem ────────────────────────────────────────────
-
-  /**
-   * Load and cache the IANA DNS bootstrap file.
-   */
-  private async ensureBootstrap(): Promise<void> {
-    if (this.bootstrapEntries) return;
-    if (this.bootstrapPromise) {
-      await this.bootstrapPromise;
-      return;
-    }
-
-    this.bootstrapPromise = (async () => {
-      try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-        try {
-          const response = await fetch(IANA_BOOTSTRAP_DNS_URL, {
-            signal: controller.signal,
-            headers: { 'User-Agent': '@push.rocks/smartnetwork' },
-          });
-          if (!response.ok) throw new Error(`HTTP ${response.status}`);
-          const data = (await response.json()) as { services: [string[], string[]][] };
-
-          const entries = new Map<string, string>();
-          for (const [tlds, urls] of data.services) {
-            const baseUrl = urls[0]; // first URL is preferred
-            if (!baseUrl) continue;
-            const cleanBase = baseUrl.replace(/\/$/, ''); // strip trailing slash
-            for (const tld of tlds) {
-              entries.set(tld.toLowerCase(), cleanBase);
-            }
-          }
-          this.bootstrapEntries = entries;
-        } finally {
-          clearTimeout(timeoutId);
-        }
-      } catch (err: any) {
-        this.logger.debug?.(`Failed to load DNS RDAP bootstrap: ${err.message}`);
-        this.bootstrapEntries = new Map(); // empty = all RDAP lookups will skip
-      }
-    })();
-
-    await this.bootstrapPromise;
-    this.bootstrapPromise = null;
-  }
-
-  /**
-   * Find the RDAP base URL for a given TLD via direct lookup.
-   */
-  private matchTld(tld: string): string | null {
-    if (!this.bootstrapEntries || this.bootstrapEntries.size === 0) return null;
-    return this.bootstrapEntries.get(tld.toLowerCase()) ?? null;
-  }
-
-  // ─── RDAP Query ─────────────────────────────────────────────────────
-
-  /**
-   * Perform the RDAP HTTP query for a domain.
-   */
-  private async queryRdap(domain: string, baseUrl: string): Promise<any | null> {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(`${baseUrl}/domain/${encodeURIComponent(domain)}`, {
-        signal: controller.signal,
-        headers: {
-          'Accept': 'application/rdap+json',
-          'User-Agent': '@push.rocks/smartnetwork',
-        },
-      });
-      if (!response.ok) return null;
-      return await response.json();
-    } catch (err: any) {
-      this.logger.debug?.(`RDAP query failed for ${domain}: ${err.message}`);
-      return null;
-    } finally {
-      clearTimeout(timeoutId);
-    }
-  }
-
-  // ─── RDAP Response Parsing ──────────────────────────────────────────
-
-  private parseRdapResponse(domain: string, data: any): IDomainIntelligenceResult {
-    const result = emptyResult(domain);
-
-    if (typeof data.handle === 'string') result.handle = data.handle;
-
-    if (Array.isArray(data.status) && data.status.length > 0) {
-      result.status = data.status.filter((s: any): s is string => typeof s === 'string');
-    }
-
-    // Events: registration / expiration / last changed
-    if (Array.isArray(data.events)) {
-      const events = this.extractEvents(data.events);
-      result.registrationDate = events.registration;
-      result.expirationDate = events.expiration;
-      result.lastChangedDate = events.lastChanged;
-    }
-
-    // Registrar (sponsor) and registrant from entities
-    if (Array.isArray(data.entities)) {
-      const registrar = this.extractRegistrar(data.entities);
-      result.registrarName = registrar.name;
-      result.registrarIanaId = registrar.ianaId;
-      result.abuseEmail = registrar.abuseEmail;
-      result.abusePhone = registrar.abusePhone;
-
-      const registrant = this.extractRegistrant(data.entities);
-      result.registrantOrg = registrant.org;
-      result.registrantCountry = registrant.country;
-    }
-
-    // Nameservers
-    if (Array.isArray(data.nameservers)) {
-      result.nameservers = this.extractNameservers(data.nameservers);
-    }
-
-    // DNSSEC: secureDNS.delegationSigned
-    if (data.secureDNS && typeof data.secureDNS.delegationSigned === 'boolean') {
-      result.dnssec = data.secureDNS.delegationSigned;
-    }
-
-    return result;
-  }
-
-  /**
-   * Pull registration / expiration / last changed timestamps from an
-   * RDAP `events` array.
-   */
-  private extractEvents(events: any[]): {
-    registration: string | null;
-    expiration: string | null;
-    lastChanged: string | null;
-  } {
-    let registration: string | null = null;
-    let expiration: string | null = null;
-    let lastChanged: string | null = null;
-
-    for (const ev of events) {
-      const action = typeof ev?.eventAction === 'string' ? ev.eventAction.toLowerCase() : '';
-      const date = typeof ev?.eventDate === 'string' ? ev.eventDate : null;
-      if (!date) continue;
-      if (action === 'registration') registration = date;
-      else if (action === 'expiration') expiration = date;
-      else if (action === 'last changed') lastChanged = date;
-    }
-
-    return { registration, expiration, lastChanged };
-  }
-
-  /**
-   * Extract registrar identity (name, IANA ID) and a nested abuse contact.
-   */
-  private extractRegistrar(entities: any[]): {
-    name: string | null;
-    ianaId: number | null;
-    abuseEmail: string | null;
-    abusePhone: string | null;
-  } {
-    let name: string | null = null;
-    let ianaId: number | null = null;
-    let abuseEmail: string | null = null;
-    let abusePhone: string | null = null;
-
-    for (const entity of entities) {
-      const roles: string[] = Array.isArray(entity?.roles) ? entity.roles : [];
-      if (!roles.includes('registrar')) continue;
-
-      name = this.extractVcardFn(entity);
-
-      // IANA Registrar ID lives in publicIds[]
-      if (Array.isArray(entity.publicIds)) {
-        for (const pid of entity.publicIds) {
-          if (pid && typeof pid === 'object' && pid.type === 'IANA Registrar ID') {
-            const parsed = parseInt(String(pid.identifier), 10);
-            if (!isNaN(parsed)) ianaId = parsed;
-          }
-        }
-      }
-
-      // Abuse contact: nested entity with role "abuse"
-      if (Array.isArray(entity.entities)) {
-        for (const sub of entity.entities) {
-          const subRoles: string[] = Array.isArray(sub?.roles) ? sub.roles : [];
-          if (subRoles.includes('abuse')) {
-            if (!abuseEmail) abuseEmail = this.extractVcardEmail(sub);
-            if (!abusePhone) abusePhone = this.extractVcardTel(sub);
-          }
-        }
-      }
-
-      break; // first registrar wins
-    }
-
-    return { name, ianaId, abuseEmail, abusePhone };
-  }
-
-  /**
-   * Extract registrant org/country from entities array.
-   */
-  private extractRegistrant(entities: any[]): {
-    org: string | null;
-    country: string | null;
-  } {
-    for (const entity of entities) {
-      const roles: string[] = Array.isArray(entity?.roles) ? entity.roles : [];
-      if (!roles.includes('registrant')) continue;
-      const org = this.extractVcardFn(entity);
-      const country = this.extractVcardCountry(entity);
-      return { org, country };
-    }
-    return { org: null, country: null };
-  }
-
-  /**
-   * Map an RDAP nameservers[] array to a list of lowercased ldhName strings.
-   */
-  private extractNameservers(nameservers: any[]): string[] | null {
-    const out: string[] = [];
-    for (const ns of nameservers) {
-      const ldh = ns?.ldhName;
-      if (typeof ldh === 'string' && ldh.length > 0) {
-        out.push(ldh.toLowerCase());
-      }
-    }
-    return out.length > 0 ? out : null;
-  }
-
   // ─── DNS Layer ──────────────────────────────────────────────────────
 
   /**
@@ -575,85 +363,4 @@ export class DomainIntelligence {
     }
     return out.length > 0 ? out : null;
   }
-
-  // ─── vCard helpers (duplicated from IpIntelligence) ─────────────────
-
-  /**
-   * Extract the 'fn' (formatted name) from an entity's vcardArray
-   */
-  private extractVcardFn(entity: any): string | null {
-    if (!entity?.vcardArray || !Array.isArray(entity.vcardArray)) return null;
-    const properties = entity.vcardArray[1];
-    if (!Array.isArray(properties)) return null;
-
-    for (const prop of properties) {
-      if (Array.isArray(prop) && prop[0] === 'fn') {
-        return prop[3] || null;
-      }
-    }
-    return null;
-  }
-
-  /**
-   * Extract email from an entity's vcardArray
-   */
-  private extractVcardEmail(entity: any): string | null {
-    if (!entity?.vcardArray || !Array.isArray(entity.vcardArray)) return null;
-    const properties = entity.vcardArray[1];
-    if (!Array.isArray(properties)) return null;
-
-    for (const prop of properties) {
-      if (Array.isArray(prop) && prop[0] === 'email') {
-        return prop[3] || null;
-      }
-    }
-    return null;
-  }
-
-  /**
-   * Extract telephone number from an entity's vcardArray
-   */
-  private extractVcardTel(entity: any): string | null {
-    if (!entity?.vcardArray || !Array.isArray(entity.vcardArray)) return null;
-    const properties = entity.vcardArray[1];
-    if (!Array.isArray(properties)) return null;
-
-    for (const prop of properties) {
-      if (Array.isArray(prop) && prop[0] === 'tel') {
-        // tel value can be a string or a uri like "tel:+1.5555555555"
-        const value = prop[3];
-        if (typeof value === 'string') {
-          return value.startsWith('tel:') ? value.slice(4) : value;
-        }
-      }
-    }
-    return null;
-  }
-
-  /**
-   * Extract country from an entity's vcardArray address field
-   */
-  private extractVcardCountry(entity: any): string | null {
-    if (!entity?.vcardArray || !Array.isArray(entity.vcardArray)) return null;
-    const properties = entity.vcardArray[1];
-    if (!Array.isArray(properties)) return null;
-
-    for (const prop of properties) {
-      if (Array.isArray(prop) && prop[0] === 'adr') {
-        // The label parameter often contains the full address with country at the end
-        const label = prop[1]?.label;
-        if (typeof label === 'string') {
-          const lines = label.split('\n');
-          const lastLine = lines[lines.length - 1]?.trim();
-          if (lastLine && lastLine.length > 1) return lastLine;
-        }
-        // Also check the structured value (7-element array, last element is country)
-        const value = prop[3];
-        if (Array.isArray(value) && value.length >= 7 && value[6]) {
-          return value[6];
-        }
-      }
-    }
-    return null;
-  }
 }