rdapper 0.5.0 → 0.7.0

package/README.md

@@ -53,6 +53,29 @@ 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:
+
+- Prefer RDAP only:
+
+```ts
+import { lookupDomain } from "rdapper";
+
+const res = await lookupDomain("example.com", { rdapOnly: true });
+```
+
+- If `rdapOnly` is omitted and the code path reaches WHOIS on edge, rdapper throws a clear runtime error indicating WHOIS is unsupported on edge and to run in Node or set `rdapOnly: true`.
+
 ### Options
 
 - `timeoutMs?: number` – Total timeout budget per network operation (default `15000`).
@@ -182,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.js

@@ -1,5 +1,4 @@
 import { parse } from "tldts";
-import { createConnection } from "node:net";
 
 //#region src/lib/domain.ts
 /**
@@ -562,9 +561,16 @@ async function whoisQuery(server, query, options) {
 		text
 	};
 }
-function queryTcp(host, port, query, options) {
+async function queryTcp(host, port, query, options) {
+	let net;
+	try {
+		net = await import("net");
+	} catch {
+		net = null;
+	}
+	if (!net?.createConnection) throw new Error("WHOIS client is only available in Node.js runtimes; try setting `rdapOnly: true`.");
 	return new Promise((resolve, reject) => {
-		const socket = createConnection({
+		const socket = net.createConnection({
 			host,
 			port
 		});
@@ -960,7 +966,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;
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdapper",
-  "version": "0.5.0",
+  "version": "0.7.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",
@@ -43,7 +48,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.5",
-    "@types/node": "24.7.1",
+    "@types/node": "24.7.2",
     "tsdown": "0.15.6",
     "typescript": "5.9.3",
     "vitest": "^3.2.4"