rdapper 0.3.0 → 0.4.0

package/README.md

@@ -4,7 +4,7 @@ RDAP‑first domain registration lookups with WHOIS fallback. Produces a single,
 
 - RDAP discovery via IANA bootstrap (`https://data.iana.org/rdap/dns.json`)
 - WHOIS TCP 43 client with TLD discovery, registrar referral follow, and curated exceptions
-- Normalized output: registrar, contacts, nameservers, statuses, dates, DNSSEC, source metadata
+- Normalized output: registrar, contacts, nameservers, statuses, dates, DNSSEC, privacy flag, source metadata
 - TypeScript types included; ESM‑only; no external HTTP client (uses global `fetch`)
 
 ### [🦉 See it in action on hoot.sh!](https://hoot.sh)
@@ -117,6 +117,7 @@ interface DomainRecord {
     country?: string;
     countryCode?: string;
   }>;
+  privacyEnabled?: boolean;   // registrant appears privacy-redacted based on keyword heuristics
   whoisServer?: string;       // authoritative WHOIS queried (if any)
   rdapServers?: string[];     // RDAP base URLs tried
   rawRdap?: unknown;          // raw RDAP JSON (only when options.includeRaw)

package/dist/index.d.ts

@@ -32,21 +32,37 @@ interface StatusEvent {
   raw?: string;
 }
 interface DomainRecord {
+  /** Normalized domain name */
   domain: string;
+  /** Terminal TLD */
   tld: string;
+  /** Whether the domain is registered */
   isRegistered: boolean;
+  /** Whether the domain is internationalized (IDN) */
   isIDN?: boolean;
+  /** Unicode name */
   unicodeName?: string;
+  /** Punycode name */
   punycodeName?: string;
+  /** Registry operator */
   registry?: string;
+  /** Registrar */
   registrar?: RegistrarInfo;
+  /** Reseller (if applicable) */
   reseller?: string;
+  /** EPP status codes */
   statuses?: StatusEvent[];
+  /** Creation date in ISO 8601 */
   creationDate?: string;
+  /** Updated date in ISO 8601 */
   updatedDate?: string;
+  /** Expiration date in ISO 8601 */
   expirationDate?: string;
+  /** Deletion date in ISO 8601 */
   deletionDate?: string;
+  /** Transfer lock */
   transferLock?: boolean;
+  /** DNSSEC data (if available) */
   dnssec?: {
     enabled: boolean;
     dsRecords?: Array<{
@@ -56,28 +72,51 @@ interface DomainRecord {
       digest?: string;
     }>;
   };
+  /** Nameservers */
   nameservers?: Nameserver[];
+  /** Contacts (registrant, admin, tech, billing, abuse, etc.) */
   contacts?: Contact[];
+  /** Best guess as to whether registrant is redacted based on keywords */
+  privacyEnabled?: boolean;
+  /** Authoritative WHOIS queried (if any) */
   whoisServer?: string;
+  /** RDAP base URLs tried */
   rdapServers?: string[];
+  /** Raw RDAP JSON */
   rawRdap?: unknown;
+  /** Raw WHOIS text (last authoritative) */
   rawWhois?: string;
+  /** Which source produced data */
   source: LookupSource;
+  /** ISO 8601 timestamp at time of lookup */
   fetchedAt: string;
+  /** Warnings generated during lookup */
   warnings?: string[];
 }
 interface LookupOptions {
+  /** Total timeout budget */
   timeoutMs?: number;
+  /** Don't fall back to WHOIS */
   rdapOnly?: boolean;
+  /** Don't attempt RDAP */
   whoisOnly?: boolean;
+  /** Follow referral server (default true) */
   followWhoisReferral?: boolean;
+  /** Maximum registrar WHOIS referral hops (default 2) */
   maxWhoisReferralHops?: number;
+  /** Follow RDAP related/entity links (default true) */
   rdapFollowLinks?: boolean;
+  /** Maximum RDAP related link fetches (default 2) */
   maxRdapLinkHops?: number;
+  /** RDAP link rels to consider (default ["related","entity","registrar","alternate"]) */
   rdapLinkRels?: string[];
+  /** Override IANA bootstrap */
   customBootstrapUrl?: string;
+  /** Override/add authoritative WHOIS per TLD */
   whoisHints?: Record<string, string>;
+  /** Include rawRdap/rawWhois in results (default false) */
   includeRaw?: boolean;
+  /** Optional cancellation signal */
   signal?: AbortSignal;
 }
 interface LookupResult {

package/dist/index.js

@@ -302,6 +302,22 @@ function sameDomain(a, b) {
 	return a.toLowerCase() === b.toLowerCase();
 }
 
+//#endregion
+//#region src/lib/privacy.ts
+const PRIVACY_NAME_KEYWORDS = [
+	"redacted",
+	"privacy",
+	"private",
+	"withheld",
+	"not disclosed",
+	"protected",
+	"protection"
+];
+function isPrivacyName(value) {
+	const v = value.toLowerCase();
+	return PRIVACY_NAME_KEYWORDS.some((k) => v.includes(k));
+}
+
 //#endregion
 //#region src/lib/text.ts
 function uniq(arr) {
@@ -382,6 +398,8 @@ function normalizeRdap(inputDomain, tld, rdap, rdapServersTried, fetchedAtISO, i
 		return n;
 	}).filter((n) => !!n.host) : void 0;
 	const contacts = extractContacts(doc.entities);
+	const registrant = contacts?.find((c) => c.type === "registrant");
+	const privacyEnabled = !!(registrant && [registrant.name, registrant.organization].filter(Boolean).some(isPrivacyName));
 	const statuses = Array.isArray(doc.status) ? doc.status.filter((s) => typeof s === "string").map((s) => ({
 		status: s,
 		raw: s
@@ -426,6 +444,7 @@ function normalizeRdap(inputDomain, tld, rdap, rdapServersTried, fetchedAtISO, i
 			host: n.host.toLowerCase()
 		}))) : void 0,
 		contacts,
+		privacyEnabled: privacyEnabled ? true : void 0,
 		whoisServer,
 		rdapServers: rdapServersTried,
 		rawRdap: includeRaw ? rdap : void 0,
@@ -799,6 +818,8 @@ function normalizeWhois(domain, tld, whoisText, whoisServer, fetchedAtISO, inclu
 		return ns;
 	}).filter((x) => !!x)) : void 0;
 	const contacts = collectContacts(map);
+	const registrant = contacts?.find((c) => c.type === "registrant");
+	const privacyEnabled = !!(registrant && [registrant.name, registrant.organization].filter(Boolean).some(isPrivacyName));
 	const dnssecRaw = (map.dnssec?.[0] || "").toLowerCase();
 	const dnssec = dnssecRaw ? { enabled: /signed|yes|true/.test(dnssecRaw) } : void 0;
 	const transferLock = !!statuses?.some((s) => /transferprohibited/i.test(s.status));
@@ -821,6 +842,7 @@ function normalizeWhois(domain, tld, whoisText, whoisServer, fetchedAtISO, inclu
 		dnssec,
 		nameservers,
 		contacts,
+		privacyEnabled: privacyEnabled ? true : void 0,
 		whoisServer,
 		rdapServers: void 0,
 		rawRdap: void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdapper",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "MIT",
   "description": "🎩 RDAP/WHOIS fetcher, parser, and normalizer for Node",
   "repository": {