jake/rdapper
1
Fork 0
mirror of https://github.com/jakejarvis/rdapper.git synced 2026-09-23 00:15:31 -04:00
Code Issues Packages Releases Activity

Refine README examples and API documentation: simplify usage of lookupDomain function and clarify fallback behavior for RDAP and WHOIS.

Browse Source
This commit is contained in:
jake
2025-09-24 19:30:22 -04:00
parent fda6d09096
commit dc0ff2a00b
1 changed files with 30 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+30 -11
View File
@@ -20,10 +20,7 @@ npm install rdapper
```ts ```ts
import { lookupDomain } from "rdapper"; import { lookupDomain } from "rdapper";
const { ok, record, error } = await lookupDomain("example.com", { const { ok, record, error } = await lookupDomain("example.com");
timeoutMs: 15000, // default 15000
followWhoisReferral: true, // default true
});
if (!ok) throw new Error(error); if (!ok) throw new Error(error);
console.log(record); // normalized DomainRecord console.log(record); // normalized DomainRecord
@@ -41,7 +38,7 @@ await isAvailable("likely-unregistered-thing-320485230458.com"); // => false
## API ## API
- `lookupDomain(domain, options?) => Promise<LookupResult>` - `lookupDomain(domain, options?) => Promise<LookupResult>`
- Tries RDAP first for the domain’s TLD; if unavailable or fails, falls back to WHOIS unless toggled off. - Tries RDAP first if supported by the domain’s TLD; if unavailable or fails, falls back to WHOIS (unless toggled off).
- Result is `{ ok: boolean, record?: DomainRecord, error?: string }`. - Result is `{ ok: boolean, record?: DomainRecord, error?: string }`.
- `isRegistered(domain, options?) => Promise<boolean>` - `isRegistered(domain, options?) => Promise<boolean>`
- `isAvailable(domain, options?) => Promise<boolean>` - `isAvailable(domain, options?) => Promise<boolean>`
@@ -54,7 +51,7 @@ await isAvailable("likely-unregistered-thing-320485230458.com"); // => false
- `followWhoisReferral?: boolean` – Follow registrar referral from the TLD WHOIS (default `true`). - `followWhoisReferral?: boolean` – Follow registrar referral from the TLD WHOIS (default `true`).
- `customBootstrapUrl?: string` – Override RDAP bootstrap URL. - `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://`). - `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`). - `includeRaw?: boolean` – Include `rawRdap`/`rawWhois` in the returned record (default `false`).
- `signal?: AbortSignal` – Optional cancellation signal. - `signal?: AbortSignal` – Optional cancellation signal.
### `DomainRecord` schema ### `DomainRecord` schema
@@ -78,7 +75,11 @@ interface DomainRecord {
phone?: string; phone?: string;
}; };
reseller?: string; reseller?: string;
statuses?: Array<{ status: string; description?: string; raw?: string }>; statuses?: Array<{
status: string;
description?: string;
raw?: string;
}>;
creationDate?: string; // ISO 8601 (UTC) creationDate?: string; // ISO 8601 (UTC)
updatedDate?: string; // ISO 8601 (UTC) updatedDate?: string; // ISO 8601 (UTC)
expirationDate?: string; // ISO 8601 (UTC) expirationDate?: string; // ISO 8601 (UTC)
@@ -86,13 +87,31 @@ interface DomainRecord {
transferLock?: boolean; // derived from EPP statuses transferLock?: boolean; // derived from EPP statuses
dnssec?: { dnssec?: {
enabled: boolean; enabled: boolean;
dsRecords?: Array<{ keyTag?: number; algorithm?: number; digestType?: number; digest?: string }>; dsRecords?: Array<{
keyTag?: number;
algorithm?: number;
digestType?: number;
digest?: string;
}>;
}; };
nameservers?: Array<{ host: string; ipv4?: string[]; ipv6?: string[] }>; nameservers?: Array<{
host: string;
ipv4?: string[];
ipv6?: string[];
}>;
contacts?: Array<{ contacts?: Array<{
type: "registrant" | "admin" | "tech" | "billing" | "abuse" | "registrar" | "reseller" | "unknown"; type: "registrant" | "admin" | "tech" | "billing" | "abuse" | "registrar" | "reseller" | "unknown";
name?: string; organization?: string; email?: string | string[]; phone?: string | string[]; fax?: string | string[]; name?: string;
street?: string[]; city?: string; state?: string; postalCode?: string; country?: string; countryCode?: string; organization?: string;
email?: string | string[];
phone?: string | string[];
fax?: string | string[];
street?: string[];
city?: string;
state?: string;
postalCode?: string;
country?: string;
countryCode?: string;
}>; }>;
whoisServer?: string; // authoritative WHOIS queried (if any) whoisServer?: string; // authoritative WHOIS queried (if any)
rdapServers?: string[]; // RDAP base URLs tried rdapServers?: string[]; // RDAP base URLs tried