rdapper 0.1.1 → 0.3.0

package/README.md

@@ -49,6 +49,10 @@ await isAvailable("likely-unregistered-thing-320485230458.com"); // => false
 - `rdapOnly?: boolean` – Only attempt RDAP; do not fall back to WHOIS.
 - `whoisOnly?: boolean` – Skip RDAP and query WHOIS directly.
 - `followWhoisReferral?: boolean` – Follow registrar referral from the TLD WHOIS (default `true`).
+- `maxWhoisReferralHops?: number` – Maximum registrar WHOIS referral hops to follow (default `2`).
+- `rdapFollowLinks?: boolean` – Follow related/entity RDAP links to enrich data (default `true`).
+- `maxRdapLinkHops?: number` – Maximum RDAP related link hops to follow (default `2`).
+- `rdapLinkRels?: string[]` – RDAP link rel values to consider (default `["related","entity","registrar","alternate"]`).
 - `customBootstrapUrl?: string` – Override RDAP bootstrap URL.
 - `whoisHints?: Record<string, string>` – Override/add authoritative WHOIS per TLD (keys are lowercase TLDs, values may include or omit `whois://`).
 - `includeRaw?: boolean` – Include `rawRdap`/`rawWhois` in the returned record (default `false`).
@@ -144,10 +148,11 @@ interface DomainRecord {
 - RDAP
   - Discovers base URLs for the TLD via IANA’s RDAP bootstrap JSON.
   - Tries each base until one responds successfully; parses standard RDAP domain JSON.
+  - Optionally follows related/entity links to registrar RDAP resources and merges results (bounded by hop limits).
   - Normalizes registrar (from `entities`), contacts (vCard), nameservers (`ipAddresses`), events (created/changed/expiration), statuses, and DNSSEC (`secureDNS`).
 - WHOIS
   - Discovers the authoritative TLD WHOIS via `whois.iana.org` (TCP 43), with curated exceptions for tricky zones and public SLDs.
-  - Queries the TLD WHOIS; if a registrar referral is present and `followWhoisReferral !== false`, follows one hop to the registrar WHOIS.
+  - Queries the TLD WHOIS and follows registrar referrals recursively up to `maxWhoisReferralHops` (unless disabled).
   - Normalizes common key/value variants across gTLD/ccTLD formats (dates, statuses, nameservers, contacts). Availability is inferred from common phrases (best‑effort heuristic).
 
 Timeouts are enforced per request using a simple race against `timeoutMs` (default 15s). All network I/O is performed with global `fetch` (RDAP) and a raw TCP socket (WHOIS).

package/dist/index.d.ts

@@ -1,13 +1,103 @@
-import type { LookupOptions, LookupResult } from "./types.js";
+//#region src/types.d.ts
+type LookupSource = "rdap" | "whois";
+interface RegistrarInfo {
+  name?: string;
+  ianaId?: string;
+  url?: string;
+  email?: string;
+  phone?: string;
+}
+interface Contact {
+  type: "registrant" | "admin" | "tech" | "billing" | "abuse" | "registrar" | "reseller" | "unknown";
+  name?: string;
+  organization?: string;
+  email?: string | string[];
+  phone?: string | string[];
+  fax?: string | string[];
+  street?: string[];
+  city?: string;
+  state?: string;
+  postalCode?: string;
+  country?: string;
+  countryCode?: string;
+}
+interface Nameserver {
+  host: string;
+  ipv4?: string[];
+  ipv6?: string[];
+}
+interface StatusEvent {
+  status: string;
+  description?: string;
+  raw?: string;
+}
+interface DomainRecord {
+  domain: string;
+  tld: string;
+  isRegistered: boolean;
+  isIDN?: boolean;
+  unicodeName?: string;
+  punycodeName?: string;
+  registry?: string;
+  registrar?: RegistrarInfo;
+  reseller?: string;
+  statuses?: StatusEvent[];
+  creationDate?: string;
+  updatedDate?: string;
+  expirationDate?: string;
+  deletionDate?: string;
+  transferLock?: boolean;
+  dnssec?: {
+    enabled: boolean;
+    dsRecords?: Array<{
+      keyTag?: number;
+      algorithm?: number;
+      digestType?: number;
+      digest?: string;
+    }>;
+  };
+  nameservers?: Nameserver[];
+  contacts?: Contact[];
+  whoisServer?: string;
+  rdapServers?: string[];
+  rawRdap?: unknown;
+  rawWhois?: string;
+  source: LookupSource;
+  fetchedAt: string;
+  warnings?: string[];
+}
+interface LookupOptions {
+  timeoutMs?: number;
+  rdapOnly?: boolean;
+  whoisOnly?: boolean;
+  followWhoisReferral?: boolean;
+  maxWhoisReferralHops?: number;
+  rdapFollowLinks?: boolean;
+  maxRdapLinkHops?: number;
+  rdapLinkRels?: string[];
+  customBootstrapUrl?: string;
+  whoisHints?: Record<string, string>;
+  includeRaw?: boolean;
+  signal?: AbortSignal;
+}
+interface LookupResult {
+  ok: boolean;
+  record?: DomainRecord;
+  error?: string;
+}
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+//#endregion
+//#region src/index.d.ts
 /**
  * High-level lookup that prefers RDAP and falls back to WHOIS.
  * Ensures a standardized DomainRecord, independent of the source.
  */
-export declare function lookupDomain(domain: string, opts?: LookupOptions): Promise<LookupResult>;
+declare function lookupDomain(domain: string, opts?: LookupOptions): Promise<LookupResult>;
 /** Determine if a domain appears available (not registered).
  * Performs a lookup and resolves to a boolean. Rejects on lookup error. */
-export declare function isAvailable(domain: string, opts?: LookupOptions): Promise<boolean>;
+declare function isAvailable(domain: string, opts?: LookupOptions): Promise<boolean>;
 /** Determine if a domain appears registered.
  * Performs a lookup and resolves to a boolean. Rejects on lookup error. */
-export declare function isRegistered(domain: string, opts?: LookupOptions): Promise<boolean>;
-export type * from "./types.js";
+declare function isRegistered(domain: string, opts?: LookupOptions): Promise<boolean>;
+//#endregion
+export { Contact, DomainRecord, FetchLike, LookupOptions, LookupResult, LookupSource, Nameserver, RegistrarInfo, StatusEvent, isAvailable, isRegistered, lookupDomain };