@push.rocks/smartnetwork 4.5.2 → 4.6.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartnetwork',
-    version: '4.5.2',
+    version: '4.6.0',
     description: 'A toolkit for network diagnostics including speed tests, port availability checks, and more.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwwQkFBMEI7SUFDaEMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDhGQUE4RjtDQUM1RyxDQUFBIn0=

package/dist_ts/index.d.ts

@@ -4,5 +4,7 @@ export { RustNetworkBridge } from './smartnetwork.classes.rustbridge.js';
 export { PublicIp } from './smartnetwork.classes.publicip.js';
 export { IpIntelligence } from './smartnetwork.classes.ipintelligence.js';
 export type { IIpIntelligenceResult, IIpIntelligenceOptions } from './smartnetwork.classes.ipintelligence.js';
+export { DomainIntelligence } from './smartnetwork.classes.domainintelligence.js';
+export type { IDomainIntelligenceResult, IDomainIntelligenceOptions } from './smartnetwork.classes.domainintelligence.js';
 export { setLogger, getLogger } from './logging.js';
 export { NetworkError, TimeoutError } from './errors.js';

package/dist_ts/index.js

@@ -2,6 +2,7 @@ export * from './smartnetwork.classes.smartnetwork.js';
 export { RustNetworkBridge } from './smartnetwork.classes.rustbridge.js';
 export { PublicIp } from './smartnetwork.classes.publicip.js';
 export { IpIntelligence } from './smartnetwork.classes.ipintelligence.js';
+export { DomainIntelligence } from './smartnetwork.classes.domainintelligence.js';
 export { setLogger, getLogger } from './logging.js';
 export { NetworkError, TimeoutError } from './errors.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHdDQUF3QyxDQUFDO0FBRXZELE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQ3pFLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUM5RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sMENBQTBDLENBQUM7QUFFMUUsT0FBTyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDcEQsT0FBTyxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsTUFBTSxhQUFhLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHdDQUF3QyxDQUFDO0FBRXZELE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQ3pFLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUM5RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sMENBQTBDLENBQUM7QUFFMUUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sOENBQThDLENBQUM7QUFFbEYsT0FBTyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDcEQsT0FBTyxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsTUFBTSxhQUFhLENBQUMifQ==

package/dist_ts/smartnetwork.classes.domainintelligence.d.ts

@@ -0,0 +1,170 @@
+import * as plugins from './smartnetwork.plugins.js';
+/** Type alias for a Smartdns client instance */
+type TSmartdnsClient = InstanceType<typeof plugins.smartdns.dnsClientMod.Smartdns>;
+/**
+ * Unified result from a domain RDAP intelligence lookup.
+ */
+export interface IDomainIntelligenceResult {
+    /** Normalized ASCII (punycode) form of the queried domain */
+    domain: string | null;
+    /** Registry handle / identifier */
+    handle: string | null;
+    /** EPP status values, e.g. ["active", "client transfer prohibited"] */
+    status: string[] | null;
+    registrationDate: string | null;
+    expirationDate: string | null;
+    lastChangedDate: string | null;
+    registrarName: string | null;
+    registrarIanaId: number | null;
+    registrantOrg: string | null;
+    registrantCountry: string | null;
+    abuseEmail: string | null;
+    abusePhone: string | null;
+    nameservers: string[] | null;
+    dnssec: boolean | null;
+    /** Which layer populated the nameservers field */
+    nameserversSource: 'rdap' | 'dns' | null;
+    /** IPv4 A records */
+    resolvedIpv4: string[] | null;
+    /** IPv6 AAAA records */
+    resolvedIpv6: string[] | null;
+    /** Parsed MX records with priority and exchange */
+    mxRecords: {
+        priority: number | null;
+        exchange: string;
+    }[] | null;
+    /** TXT records (SPF, DKIM, site verification, etc.) */
+    txtRecords: string[] | null;
+    /** Raw serialized SOA record value */
+    soaRecord: string | null;
+}
+/**
+ * Options for DomainIntelligence
+ */
+export interface IDomainIntelligenceOptions {
+    /** Timeout (ms) for RDAP/bootstrap/DNS requests. Default: 5000 */
+    timeout?: number;
+    /**
+     * Optional injected smartdns client. When provided, DomainIntelligence
+     * will not create or destroy its own client (the owner — typically
+     * SmartNetwork — manages lifecycle). When omitted, a short-lived client
+     * is created per DNS-layer query and destroyed in finally.
+     */
+    dnsClient?: TSmartdnsClient;
+}
+/**
+ * DomainIntelligence performs RDAP lookups for domain names using the
+ * IANA DNS bootstrap to discover the correct registry RDAP endpoint per TLD.
+ */
+export declare class DomainIntelligence {
+    private readonly logger;
+    private readonly timeout;
+    private bootstrapEntries;
+    private bootstrapPromise;
+    private readonly sharedDnsClient;
+    constructor(options?: IDomainIntelligenceOptions);
+    /**
+     * Get comprehensive domain intelligence. Runs RDAP and DNS lookups in
+     * parallel, then merges the results. Returns an all-null result (rather
+     * than throwing) for malformed input, unknown TLDs, or total failure.
+     *
+     * - RDAP provides: registrar, registrant, events (registration/expiration),
+     *   nameservers (registry/parent), status, DNSSEC, abuse contact
+     * - DNS provides: A/AAAA records, MX, TXT, SOA, and a nameservers fallback
+     *   when RDAP is unavailable (closes the ccTLD gap)
+     */
+    getIntelligence(domain: string): Promise<IDomainIntelligenceResult>;
+    /**
+     * 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.
+     */
+    private queryRdapLayer;
+    /**
+     * Normalize a domain to lowercased ASCII punycode form. Returns null for
+     * obviously invalid input.
+     */
+    private normalizeDomain;
+    /**
+     * Extract the TLD as the last dot-separated label.
+     */
+    private extractTld;
+    /**
+     * Load and cache the IANA DNS bootstrap file.
+     */
+    private ensureBootstrap;
+    /**
+     * Find the RDAP base URL for a given TLD via direct lookup.
+     */
+    private matchTld;
+    /**
+     * Perform the RDAP HTTP query for a domain.
+     */
+    private queryRdap;
+    private parseRdapResponse;
+    /**
+     * Pull registration / expiration / last changed timestamps from an
+     * RDAP `events` array.
+     */
+    private extractEvents;
+    /**
+     * Extract registrar identity (name, IANA ID) and a nested abuse contact.
+     */
+    private extractRegistrar;
+    /**
+     * Extract registrant org/country from entities array.
+     */
+    private extractRegistrant;
+    /**
+     * Map an RDAP nameservers[] array to a list of lowercased ldhName strings.
+     */
+    private extractNameservers;
+    /**
+     * Run DNS record lookups for the given domain using smartdns. Queries
+     * NS/A/AAAA/MX/TXT/SOA in parallel via Promise.allSettled — failures in
+     * one record type do not affect the others. Returns an object with each
+     * field either populated or null.
+     *
+     * If a shared dnsClient was injected via constructor options, it is
+     * reused and NOT destroyed (ownership stays with the injector). Otherwise
+     * a short-lived client is created and destroyed in finally.
+     */
+    private queryDnsLayer;
+    /**
+     * Extract normalized nameserver hostnames from a getNameServers() result.
+     */
+    private parseNsResult;
+    /**
+     * Extract `value` strings from a settled DNS lookup result.
+     */
+    private dnsValuesOrNull;
+    /**
+     * First non-empty value from a settled DNS lookup result.
+     */
+    private dnsFirstValueOrNull;
+    /**
+     * Parse MX records into {priority, exchange} pairs. smartdns returns MX
+     * values as serialized strings (typically "10 mail.example.com"). We
+     * best-effort parse the priority; if parsing fails we store the whole
+     * value as the exchange with priority=null so the result is still useful.
+     */
+    private parseMxRecords;
+    /**
+     * Extract the 'fn' (formatted name) from an entity's vcardArray
+     */
+    private extractVcardFn;
+    /**
+     * Extract email from an entity's vcardArray
+     */
+    private extractVcardEmail;
+    /**
+     * Extract telephone number from an entity's vcardArray
+     */
+    private extractVcardTel;
+    /**
+     * Extract country from an entity's vcardArray address field
+     */
+    private extractVcardCountry;
+}
+export {};