rdapper 0.7.0 → 0.8.0

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 ?? "";
@@ -1056,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.7.0",
+  "version": "0.8.0",
   "license": "MIT",
   "description": "🎩 RDAP/WHOIS fetcher, parser, and normalizer for Node",
   "repository": {
@@ -47,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"
   },