rdapper 0.1.0 → 0.2.0

package/README.md

@@ -7,7 +7,7 @@ RDAP‑first domain registration lookups with WHOIS fallback. Produces a single,
 - Normalized output: registrar, contacts, nameservers, statuses, dates, DNSSEC, source metadata
 - TypeScript types included; ESM‑only; no external HTTP client (uses global `fetch`)
 
-Requirements: Node >= 18.17 (global `fetch`). WHOIS uses TCP port 43.
+### [🦉 See it in action on hoot.sh!](https://hoot.sh)
 
 ## Install
 
@@ -155,9 +155,11 @@ Timeouts are enforced per request using a simple race against `timeoutMs` (defau
 ## Development
 
 - Build: `npm run build`
-- Test: `npm test`
+- Test: `npm test` (Vitest)
   - By default, tests are offline/deterministic.
-  - Smoke tests that hit the network are gated by `SMOKE=1`, e.g. `SMOKE=1 npm test`.
+  - Watch mode: `npm run test:watch`
+  - Coverage: `npm run test:coverage`
+  - Smoke tests that hit the network are gated by `SMOKE=1`, e.g. `SMOKE=1 npm run test:smoke`.
 - Lint/format: `npm run lint` (Biome)
 
 Project layout:

package/dist/index.d.ts

@@ -1,13 +1,99 @@
-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;
+  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 };