rdapper 0.6.0 → 0.8.0

package/README.md

@@ -53,6 +53,15 @@ toRegistrableDomain("192.168.0.1");                      // => null
 - `isRegistered(domain, options?) => Promise<boolean>`
 - `isAvailable(domain, options?) => Promise<boolean>`
 
+### CLI
+
+For quick checks, a minimal CLI is included:
+
+```bash
+npx rdapper example.com
+echo "example.com" | npx rdapper
+```
+
 ### Edge runtimes (e.g., Vercel Edge)
 
 WHOIS requires a raw TCP connection over port 43 via `node:net`, which is not available on edge runtimes. This package lazily loads `node:net` only when the WHOIS code path runs. To use rdapper safely on edge:
@@ -196,7 +205,7 @@ Project layout:
 - `src/whois/` – WHOIS TCP client, discovery/referral, normalization, exceptions
 - `src/lib/` – utilities for dates, text parsing, domain processing, async
 - `src/types.ts` – public types; `src/index.ts` re‑exports API and types
-- `cli.mjs` – local CLI helper for quick testing
+- `bin/cli.js` – simple CLI for quick checks
 
 ## Caveats
 

package/bin/cli.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+// Quick informal command-line interface for rdapper
+// Usage:
+//   npx rdapper example.com
+//   echo "example.com" | npx rdapper
+
+import { createInterface } from "node:readline";
+import { lookupDomain } from "../dist/index.js";
+
+async function main() {
+  if (process.argv.length > 2) {
+    // URL(s) specified in the command arguments
+    console.log(
+      JSON.stringify(
+        await lookupDomain(process.argv[process.argv.length - 1]),
+        null,
+        2,
+      ),
+    );
+  } else {
+    // No domain passed as argument, read from each line of stdin
+    const rlInterface = createInterface({
+      input: process.stdin,
+    });
+    rlInterface.on("line", async (line) => {
+      console.log(JSON.stringify(await lookupDomain(line), null, 2));
+    });
+  }
+}
+
+main();

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { parse } from "tldts";
+
 //#region src/types.d.ts
 type LookupSource = "rdap" | "whois";
 interface RegistrarInfo {
@@ -125,11 +127,23 @@ interface LookupResult {
 type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 //#endregion
 //#region src/lib/domain.d.ts
+type ParseOptions = Parameters<typeof parse>[1];
+/**
+ * Parse a domain into its parts. Accepts options which are passed to tldts.parse().
+ * @see https://github.com/remusao/tldts/blob/master/packages/tldts-core/src/options.ts
+ */
+declare function getDomainParts(domain: string, opts?: ParseOptions): ReturnType<typeof parse>;
+/** Get the TLD (ICANN-only public suffix) of a domain. */
+declare function getDomainTld(domain: string, opts?: ParseOptions): string | null;
+/**
+ * Basic domain validity check (hostname-like), not performing DNS or RDAP.
+ */
+declare function isLikelyDomain(value: string): boolean;
 /**
  * Normalize arbitrary input (domain or URL) to its registrable domain (eTLD+1).
  * Returns null when the input is not a valid ICANN domain (e.g., invalid TLD, IPs).
  */
-declare function toRegistrableDomain(input: string): string | null;
+declare function toRegistrableDomain(input: string, opts?: ParseOptions): string | null;
 //#endregion
 //#region src/index.d.ts
 /**
@@ -144,4 +158,4 @@ declare function isAvailable(domain: string, opts?: LookupOptions): Promise<bool
  * Performs a lookup and resolves to a boolean. Rejects on lookup error. */
 declare function isRegistered(domain: string, opts?: LookupOptions): Promise<boolean>;
 //#endregion
-export { Contact, DomainRecord, FetchLike, LookupOptions, LookupResult, LookupSource, Nameserver, RegistrarInfo, StatusEvent, isAvailable, isRegistered, lookupDomain, toRegistrableDomain };
+export { Contact, DomainRecord, FetchLike, LookupOptions, LookupResult, LookupSource, Nameserver, RegistrarInfo, StatusEvent, getDomainParts, getDomainTld, isAvailable, isLikelyDomain, isRegistered, lookupDomain, toRegistrableDomain };

package/dist/index.js

@@ -2,10 +2,18 @@ import { parse } from "tldts";
 
 //#region src/lib/domain.ts
 /**
-* Parse a domain into its parts.
+* Parse a domain into its parts. Accepts options which are passed to tldts.parse().
+* @see https://github.com/remusao/tldts/blob/master/packages/tldts-core/src/options.ts
 */
-function getDomainParts(domain) {
-	return parse(domain);
+function getDomainParts(domain, opts) {
+	return parse(domain, { ...opts });
+}
+/** Get the TLD (ICANN-only public suffix) of a domain. */
+function getDomainTld(domain, opts) {
+	return getDomainParts(domain, {
+		allowPrivateDomains: false,
+		...opts
+	}).publicSuffix ?? null;
 }
 /**
 * Basic domain validity check (hostname-like), not performing DNS or RDAP.
@@ -18,10 +26,13 @@ function isLikelyDomain(value) {
 * Normalize arbitrary input (domain or URL) to its registrable domain (eTLD+1).
 * Returns null when the input is not a valid ICANN domain (e.g., invalid TLD, IPs).
 */
-function toRegistrableDomain(input) {
+function toRegistrableDomain(input, opts) {
 	const raw = (input ?? "").trim();
 	if (raw === "") return null;
-	const result = parse(raw);
+	const result = getDomainParts(raw, {
+		allowPrivateDomains: false,
+		...opts
+	});
 	if (result.isIp) return null;
 	if (!result.isIcann) return null;
 	const domain = result.domain ?? "";
@@ -966,7 +977,11 @@ async function followWhoisReferrals(initialServer, domain, opts) {
 		if (visited.has(normalized)) break;
 		visited.add(normalized);
 		try {
-			current = await whoisQuery(next, domain, opts);
+			const res = await whoisQuery(next, domain, opts);
+			const registeredBefore = !isWhoisAvailable(current.text);
+			const registeredAfter = !isWhoisAvailable(res.text);
+			if (registeredBefore && !registeredAfter) break;
+			current = res;
 		} catch {
 			break;
 		}
@@ -1052,4 +1067,4 @@ async function isRegistered(domain, opts) {
 }
 
 //#endregion
-export { isAvailable, isRegistered, lookupDomain, toRegistrableDomain };
+export { getDomainParts, getDomainTld, isAvailable, isLikelyDomain, isRegistered, lookupDomain, toRegistrableDomain };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdapper",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "license": "MIT",
   "description": "🎩 RDAP/WHOIS fetcher, parser, and normalizer for Node",
   "repository": {
@@ -15,15 +15,19 @@
     "email": "jake@jarv.is",
     "url": "https://jarv.is"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": "./bin/cli.js",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js",
       "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/index.d.ts"
     }
   },
   "files": [
@@ -32,6 +36,7 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
+    "cli": "node bin/cli.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest",
     "test:run": "vitest run",
@@ -42,9 +47,9 @@
     "tldts": "7.0.17"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.5",
-    "@types/node": "24.7.2",
-    "tsdown": "0.15.6",
+    "@biomejs/biome": "2.2.6",
+    "@types/node": "24.8.1",
+    "tsdown": "0.15.7",
     "typescript": "5.9.3",
     "vitest": "^3.2.4"
   },