@chez14/rdap-sdk 0.1.1-5 → 0.1.1-8

package/README.md

@@ -51,7 +51,7 @@ const asn = await client.autnum(174);
 console.log(asn.name);
 
 // Use custom base domain (default is www.rdap.net)
-const customClient = new RdapOrgClient({
+const customClient = new RdapClient({
   baseDomain: 'custom.rdap.example.com'
 });
 ```
@@ -85,7 +85,7 @@ class CustomFetcher implements Fetcher {
 }
 
 // Use your custom fetcher
-const client = new RdapOrgClient({
+const client = new RdapClient({
   fetcher: new CustomFetcher('MyApp/1.0 (https://example.com)'),
 });
 ```

package/dist/index.d.ts

@@ -1,55 +1,165 @@
-/**
- * Base response interface for RDAP queries
- */
-interface RdapResponse {
-    rdapConformance: string[];
-    notices?: Array<{
-        title?: string;
-        description: string[];
-        links?: Array<{
-            value: string;
-            rel: string;
-            href: string;
-            type?: string;
-        }>;
-    }>;
+interface RdapLink {
+    value: string;
+    rel: string;
+    href: string;
+    hreflang?: string[];
+    type?: string;
+    media?: string;
+    title?: string;
 }
-/**
- * Domain response interface
- */
-interface DomainResponse extends RdapResponse {
+interface RdapEvent {
+    eventAction: string;
+    eventActor?: string;
+    eventDate: string;
+    links?: RdapLink[];
+}
+interface RdapPublicID {
+    type: string;
+    identifier: string;
+}
+type RdapStatus = 'validated' | 'renew prohibited' | 'update prohibited' | 'transfer prohibited' | 'delete prohibited' | 'proxy' | 'private' | 'removed' | 'obscured' | 'associated' | 'active' | 'inactive' | 'locked' | 'pending create' | 'pending renew' | 'pending transfer' | 'pending update' | 'pending delete';
+type RdapNoticeAndRemarkTypes = 'result set truncated due to authorization' | 'result set truncated due to excessive load' | 'result set truncated due to unexplainable reasons' | 'object truncated due to authorization' | 'object truncated due to excessive load' | 'object truncated due to unexplainable reasons';
+interface RdapRemark {
+    title?: string;
+    type?: RdapNoticeAndRemarkTypes;
+    description: string[];
+    links?: RdapLink[];
+}
+interface RdapDsData {
+    keyTag?: number;
+    algorithm?: number;
+    digest?: string;
+    digestType?: string;
+    events?: RdapEvent[];
+    links?: RdapLink[];
+}
+interface RdapKeyData {
+    flags?: number;
+    protocol?: number;
+    publicKey?: string;
+    algorithm?: number;
+    events?: RdapEvent[];
+    links?: RdapLink[];
+}
+interface RdapSecureDNS {
+    zoneSigned?: boolean;
+    delegationSigned?: boolean;
+    maxSigLife?: number;
+    dsData?: RdapDsData[];
+    keyData?: RdapKeyData[];
+}
+type RdapNotice = RdapRemark;
+type RdapObjectClass = RdapEntityObjectClass | RdapNameserverObjectClass | RdapDomainObjectClass;
+interface RdapEntityObjectClass {
+    objectClassName: 'entity';
+    handle?: string;
+    vcardArray?: any[];
+    roles?: string[];
+    publicIds?: RdapPublicID[];
+    entities?: RdapEntityObjectClass[];
+    remarks?: RdapRemark[];
+    links?: RdapLink[];
+    events?: RdapEvent[];
+    asEventActor?: Omit<RdapEvent, 'eventActor'>[];
+    status?: RdapStatus[];
+    port43?: string;
+    networks?: RdapIPNetworkObjectClass[];
+    autnums?: RdapAutonomousSystemNumberObjectClass[];
+}
+interface RdapNameserverObjectClass {
+    objectClassName: 'nameserver';
+    handle?: string;
+    ldhName?: string;
+    unicodeName?: string;
+    ipAddresses?: {
+        v6: string[];
+        v4: string[];
+    };
+    entities?: RdapEntityObjectClass[];
+    status?: RdapStatus[];
+    remarks?: RdapRemark[];
+    links?: RdapLink[];
+    port43?: string;
+    events?: RdapEvent[];
+}
+interface RdapDomainObjectClass {
     objectClassName: 'domain';
     handle?: string;
-    ldhName: string;
-    links: Array<{
-        rel: string;
-        href: string;
-        type?: string;
-    }>;
+    ldhName?: string;
+    unicodeName?: string;
+    variants: {
+        relation: string[];
+        idnTable: string;
+        variantName: {
+            ldhName: string;
+            unicodeName: string;
+        }[];
+    }[];
+    nameservers: RdapNameserverObjectClass[];
+    secureDNS: RdapSecureDNS;
+    entities?: RdapEntityObjectClass[];
+    status?: RdapStatus[];
+    publicIds?: RdapPublicID[];
+    remarks: RdapRemark[];
+    links?: RdapLink[];
+    port43?: string;
+    events?: RdapEvent[];
+    network?: RdapIPNetworkObjectClass;
 }
-/**
- * IP Network response interface
- */
-interface IpNetworkResponse extends RdapResponse {
+interface RdapIPNetworkObjectClass {
     objectClassName: 'ip network';
-    handle: string;
-    startAddress: string;
-    endAddress: string;
-    ipVersion: string;
+    handle?: string;
+    startAddress?: string;
+    endAddress?: string;
+    ipVersion?: 'v4' | 'v6';
     name?: string;
     type?: string;
+    country?: string;
+    parentHandle?: string;
+    status?: RdapStatus[];
+    entities?: RdapEntityObjectClass[];
+    remarks: RdapRemark[];
+    links?: RdapLink[];
+    port43?: string;
+    events?: RdapEvent[];
 }
-/**
- * Autonomous System Number response interface
- */
-interface AutonomousSystemResponse extends RdapResponse {
+interface RdapAutonomousSystemNumberObjectClass {
     objectClassName: 'autnum';
-    handle: string;
-    startAutnum: number;
-    endAutnum: number;
+    handle?: string;
+    startAutnum?: string;
+    endAutnum?: string;
     name?: string;
     type?: string;
+    status?: RdapStatus[];
+    country?: string;
+    entities?: RdapEntityObjectClass[];
+    remarks: RdapRemark[];
+    links?: RdapLink[];
+    port43?: string;
+    events?: RdapEvent[];
+}
+interface RdapDomainSuccessResponse extends RdapDomainObjectClass {
+    rdapConformance: string[];
 }
+interface RdapIpSuccessResponse extends RdapIPNetworkObjectClass {
+    rdapConformance: string[];
+}
+interface RdapAutnumSuccessResponse extends RdapAutonomousSystemNumberObjectClass {
+    rdapConformance: string[];
+}
+interface RdapHelpSuccessResponse {
+    rdapConformance: string[];
+    notices?: RdapNotice[];
+}
+interface RdapErrorResponse {
+    errorCode: number;
+    title?: string;
+    description?: string[];
+}
+type RdapDomainResponse = RdapErrorResponse & RdapDomainSuccessResponse;
+type RdapIpResponse = RdapErrorResponse & RdapIpSuccessResponse;
+type RdapAutnumResponse = RdapErrorResponse & RdapAutnumSuccessResponse;
+type RdapHelpResponse = RdapErrorResponse & RdapHelpSuccessResponse;
 
 /**
  * HTTP methods supported by the fetcher
@@ -71,6 +181,7 @@ interface FetchResponse<T = unknown> {
     status: number;
     data: T;
     headers: Headers;
+    url: string;
 }
 /**
  * Interface for the fetcher implementation
@@ -85,14 +196,14 @@ declare class DefaultFetcher implements Fetcher {
     fetch<TBody = unknown, TResponse = unknown>({ method, url, body, headers, }: FetchOptions<TBody>): Promise<FetchResponse<TResponse>>;
 }
 
-interface RdapOrgClientOptions {
+interface RdapClientOptions {
     fetcher?: Fetcher;
     baseDomain?: string;
 }
 declare class RdapClient {
     private readonly fetcher;
     private readonly baseDomain;
-    constructor(options?: RdapOrgClientOptions);
+    constructor(options?: RdapClientOptions);
     /**
      * Convert domain to punycode if needed
      */
@@ -103,37 +214,37 @@ declare class RdapClient {
      * @returns Domain information
      * @example
      * ```typescript
-     * const client = new RdapOrgClient();
+     * const client = new RdapClient();
      * const domain = await client.domain('example.com');
      * // IDN support
      * const idn = await client.domain('münchen.de');
      * ```
      */
-    domain(domain: string): Promise<DomainResponse>;
+    domain(domain: string): Promise<RdapDomainResponse>;
     /**
      * Query IP address or network information
      * @param ip IP address or CIDR notation
      * @returns IP network information
      * @example
      * ```typescript
-     * const client = new RdapOrgClient();
+     * const client = new RdapClient();
      * const ip = await client.ip('8.8.8.8');
      * // or with CIDR notation
      * const network = await client.ip('2001:db8::1/128');
      * ```
      */
-    ip(ip: string): Promise<IpNetworkResponse>;
+    ip(ip: string): Promise<RdapIpResponse>;
     /**
      * Query Autonomous System Number information
      * @param asn Autonomous System Number
      * @returns ASN information
      * @example
      * ```typescript
-     * const client = new RdapOrgClient();
+     * const client = new RdapClient();
      * const asn = await client.autnum(174);
      * ```
      */
-    autnum(asn: number): Promise<AutonomousSystemResponse>;
+    autnum(asn: number): Promise<RdapAutnumResponse>;
 }
 
-export { type AutonomousSystemResponse, DefaultFetcher, type DomainResponse, type FetchOptions, type FetchResponse, type Fetcher, type HttpMethod, type IpNetworkResponse, RdapClient, type RdapOrgClientOptions, type RdapResponse };
+export { DefaultFetcher, type FetchOptions, type FetchResponse, type Fetcher, type HttpMethod, type RdapAutnumResponse, type RdapAutnumSuccessResponse, type RdapAutonomousSystemNumberObjectClass, RdapClient, type RdapClientOptions, type RdapDomainObjectClass, type RdapDomainResponse, type RdapDomainSuccessResponse, type RdapDsData, type RdapEntityObjectClass, type RdapErrorResponse, type RdapEvent, type RdapHelpResponse, type RdapHelpSuccessResponse, type RdapIPNetworkObjectClass, type RdapIpResponse, type RdapIpSuccessResponse, type RdapKeyData, type RdapLink, type RdapNameserverObjectClass, type RdapNotice, type RdapNoticeAndRemarkTypes, type RdapObjectClass, type RdapPublicID, type RdapRemark, type RdapSecureDNS, type RdapStatus };

package/dist/index.js

@@ -27,11 +27,20 @@ var DefaultFetcher = class {
     return {
       status: response.status,
       data,
-      headers: response.headers
+      headers: response.headers,
+      url: response.url
     };
   }
 };
 
+// src/utils/throwables.ts
+var RdapNotFoundError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "RdapNotFoundError";
+  }
+};
+
 // src/client.ts
 var RdapClient = class {
   constructor(options = {}) {
@@ -60,7 +69,7 @@ var RdapClient = class {
    * @returns Domain information
    * @example
    * ```typescript
-   * const client = new RdapOrgClient();
+   * const client = new RdapClient();
    * const domain = await client.domain('example.com');
    * // IDN support
    * const idn = await client.domain('münchen.de');
@@ -68,10 +77,14 @@ var RdapClient = class {
    */
   async domain(domain) {
     const punyDomain = this.prepareDomain(domain);
+    const url = `https://${this.baseDomain}/domain/${encodeURIComponent(punyDomain)}`;
     const response = await this.fetcher.fetch({
       method: "GET",
-      url: `https://${this.baseDomain}/domain/${encodeURIComponent(punyDomain)}`
+      url
     });
+    if (response.status === 404 && response.url === url) {
+      throw new RdapNotFoundError(`Domain ${domain} has no RDAP server for its TLD`);
+    }
     return response.data;
   }
   /**
@@ -80,7 +93,7 @@ var RdapClient = class {
    * @returns IP network information
    * @example
    * ```typescript
-   * const client = new RdapOrgClient();
+   * const client = new RdapClient();
    * const ip = await client.ip('8.8.8.8');
    * // or with CIDR notation
    * const network = await client.ip('2001:db8::1/128');
@@ -99,7 +112,7 @@ var RdapClient = class {
    * @returns ASN information
    * @example
    * ```typescript
-   * const client = new RdapOrgClient();
+   * const client = new RdapClient();
    * const asn = await client.autnum(174);
    * ```
    */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/fetcher.ts","../src/client.ts"],"sourcesContent":["/**\n * HTTP methods supported by the fetcher\n */\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n\n/**\n * Options for the fetch request\n */\nexport interface FetchOptions<T = unknown> {\n  method: HttpMethod;\n  url: string;\n  body?: T;\n  headers?: Record<string, string>;\n}\n\n/**\n * Response from the fetch request\n */\nexport interface FetchResponse<T = unknown> {\n  status: number;\n  data: T;\n  headers: Headers;\n}\n\n/**\n * Interface for the fetcher implementation\n */\nexport interface Fetcher {\n  fetch<TBody = unknown, TResponse = unknown>(\n    options: FetchOptions<TBody>,\n  ): Promise<FetchResponse<TResponse>>;\n}\n\n/**\n * Default fetcher implementation using node-fetch\n */\nexport class DefaultFetcher implements Fetcher {\n  async fetch<TBody = unknown, TResponse = unknown>({\n    method,\n    url,\n    body,\n    headers = {},\n  }: FetchOptions<TBody>): Promise<FetchResponse<TResponse>> {\n    const requestUrl = new URL(url);\n\n    // For GET requests, convert body to query parameters\n    if (method === 'GET' && body) {\n      Object.entries(body as Record<string, string>).forEach(([key, value]) => {\n        requestUrl.searchParams.append(key, value);\n      });\n    }\n\n    const requestInit: RequestInit = {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        ...headers,\n      },\n    };\n\n    // Add body for non-GET requests\n    if (method !== 'GET' && body) {\n      requestInit.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(requestUrl, requestInit);\n    const data = (await response.json()) as TResponse;\n\n    return {\n      status: response.status,\n      data,\n      headers: response.headers,\n    };\n  }\n}\n","import { AutonomousSystemResponse, DomainResponse, IpNetworkResponse } from './types';\nimport { DefaultFetcher, Fetcher } from './utils/fetcher';\n\nexport interface RdapOrgClientOptions {\n  fetcher?: Fetcher;\n  baseDomain?: string;\n}\n\nexport class RdapClient {\n  private readonly fetcher: Fetcher;\n  private readonly baseDomain: string;\n\n  constructor(options: RdapOrgClientOptions = {}) {\n    this.fetcher = options.fetcher ?? new DefaultFetcher();\n    this.baseDomain = options.baseDomain ?? 'www.rdap.net';\n  }\n\n  /**\n   * Convert domain to punycode if needed\n   */\n  private prepareDomain(domain: string): string {\n    return domain\n      .toLowerCase()\n      .split('.')\n      .map((part) => {\n        try {\n          if (part.includes('xn--')) {\n            return part;\n          }\n          // Use URL API to handle IDN conversion\n          const url = new URL(`https://${part}`);\n          return url.hostname.startsWith('xn--') ? url.hostname : part;\n        } catch {\n          return part;\n        }\n      })\n      .join('.');\n  }\n\n  /**\n   * Query domain information\n   * @param domain Domain name to query (supports IDN/punycode)\n   * @returns Domain information\n   * @example\n   * ```typescript\n   * const client = new RdapOrgClient();\n   * const domain = await client.domain('example.com');\n   * // IDN support\n   * const idn = await client.domain('münchen.de');\n   * ```\n   */\n  async domain(domain: string): Promise<DomainResponse> {\n    const punyDomain = this.prepareDomain(domain);\n    const response = await this.fetcher.fetch<never, DomainResponse>({\n      method: 'GET',\n      url: `https://${this.baseDomain}/domain/${encodeURIComponent(punyDomain)}`,\n    });\n\n    return response.data;\n  }\n\n  /**\n   * Query IP address or network information\n   * @param ip IP address or CIDR notation\n   * @returns IP network information\n   * @example\n   * ```typescript\n   * const client = new RdapOrgClient();\n   * const ip = await client.ip('8.8.8.8');\n   * // or with CIDR notation\n   * const network = await client.ip('2001:db8::1/128');\n   * ```\n   */\n  async ip(ip: string): Promise<IpNetworkResponse> {\n    const response = await this.fetcher.fetch<never, IpNetworkResponse>({\n      method: 'GET',\n      url: `https://${this.baseDomain}/ip/${encodeURIComponent(ip)}`,\n    });\n\n    return response.data;\n  }\n\n  /**\n   * Query Autonomous System Number information\n   * @param asn Autonomous System Number\n   * @returns ASN information\n   * @example\n   * ```typescript\n   * const client = new RdapOrgClient();\n   * const asn = await client.autnum(174);\n   * ```\n   */\n  async autnum(asn: number): Promise<AutonomousSystemResponse> {\n    const response = await this.fetcher.fetch<never, AutonomousSystemResponse>({\n      method: 'GET',\n      url: `https://${this.baseDomain}/autnum/${asn}`,\n    });\n\n    return response.data;\n  }\n}\n"],"mappings":";AAoCO,IAAM,iBAAN,MAAwC;AAAA,EAC7C,MAAM,MAA4C;AAAA,IAChD;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU,CAAC;AAAA,EACb,GAA2D;AACzD,UAAM,aAAa,IAAI,IAAI,GAAG;AAG9B,QAAI,WAAW,SAAS,MAAM;AAC5B,aAAO,QAAQ,IAA8B,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACvE,mBAAW,aAAa,OAAO,KAAK,KAAK;AAAA,MAC3C,CAAC;AAAA,IACH;AAEA,UAAM,cAA2B;AAAA,MAC/B;AAAA,MACA,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,MACL;AAAA,IACF;AAGA,QAAI,WAAW,SAAS,MAAM;AAC5B,kBAAY,OAAO,KAAK,UAAU,IAAI;AAAA,IACxC;AAEA,UAAM,WAAW,MAAM,MAAM,YAAY,WAAW;AACpD,UAAM,OAAQ,MAAM,SAAS,KAAK;AAElC,WAAO;AAAA,MACL,QAAQ,SAAS;AAAA,MACjB;AAAA,MACA,SAAS,SAAS;AAAA,IACpB;AAAA,EACF;AACF;;;AClEO,IAAM,aAAN,MAAiB;AAAA,EAItB,YAAY,UAAgC,CAAC,GAAG;AAC9C,SAAK,UAAU,QAAQ,WAAW,IAAI,eAAe;AACrD,SAAK,aAAa,QAAQ,cAAc;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,QAAwB;AAC5C,WAAO,OACJ,YAAY,EACZ,MAAM,GAAG,EACT,IAAI,CAAC,SAAS;AACb,UAAI;AACF,YAAI,KAAK,SAAS,MAAM,GAAG;AACzB,iBAAO;AAAA,QACT;AAEA,cAAM,MAAM,IAAI,IAAI,WAAW,IAAI,EAAE;AACrC,eAAO,IAAI,SAAS,WAAW,MAAM,IAAI,IAAI,WAAW;AAAA,MAC1D,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF,CAAC,EACA,KAAK,GAAG;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,OAAO,QAAyC;AACpD,UAAM,aAAa,KAAK,cAAc,MAAM;AAC5C,UAAM,WAAW,MAAM,KAAK,QAAQ,MAA6B;AAAA,MAC/D,QAAQ;AAAA,MACR,KAAK,WAAW,KAAK,UAAU,WAAW,mBAAmB,UAAU,CAAC;AAAA,IAC1E,CAAC;AAED,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,GAAG,IAAwC;AAC/C,UAAM,WAAW,MAAM,KAAK,QAAQ,MAAgC;AAAA,MAClE,QAAQ;AAAA,MACR,KAAK,WAAW,KAAK,UAAU,OAAO,mBAAmB,EAAE,CAAC;AAAA,IAC9D,CAAC;AAED,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,OAAO,KAAgD;AAC3D,UAAM,WAAW,MAAM,KAAK,QAAQ,MAAuC;AAAA,MACzE,QAAQ;AAAA,MACR,KAAK,WAAW,KAAK,UAAU,WAAW,GAAG;AAAA,IAC/C,CAAC;AAED,WAAO,SAAS;AAAA,EAClB;AACF;","names":[]}
+{"version":3,"sources":["../src/utils/fetcher.ts","../src/utils/throwables.ts","../src/client.ts"],"sourcesContent":["/**\n * HTTP methods supported by the fetcher\n */\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n\n/**\n * Options for the fetch request\n */\nexport interface FetchOptions<T = unknown> {\n  method: HttpMethod;\n  url: string;\n  body?: T;\n  headers?: Record<string, string>;\n}\n\n/**\n * Response from the fetch request\n */\nexport interface FetchResponse<T = unknown> {\n  status: number;\n  data: T;\n  headers: Headers;\n  url: string;\n}\n\n/**\n * Interface for the fetcher implementation\n */\nexport interface Fetcher {\n  fetch<TBody = unknown, TResponse = unknown>(\n    options: FetchOptions<TBody>,\n  ): Promise<FetchResponse<TResponse>>;\n}\n\n/**\n * Default fetcher implementation using node-fetch\n */\nexport class DefaultFetcher implements Fetcher {\n  async fetch<TBody = unknown, TResponse = unknown>({\n    method,\n    url,\n    body,\n    headers = {},\n  }: FetchOptions<TBody>): Promise<FetchResponse<TResponse>> {\n    const requestUrl = new URL(url);\n\n    // For GET requests, convert body to query parameters\n    if (method === 'GET' && body) {\n      Object.entries(body as Record<string, string>).forEach(([key, value]) => {\n        requestUrl.searchParams.append(key, value);\n      });\n    }\n\n    const requestInit: RequestInit = {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        ...headers,\n      },\n    };\n\n    // Add body for non-GET requests\n    if (method !== 'GET' && body) {\n      requestInit.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(requestUrl, requestInit);\n    const data = (await response.json()) as TResponse;\n\n    return {\n      status: response.status,\n      data,\n      headers: response.headers,\n      url: response.url,\n    };\n  }\n}\n","export class RdapNotFoundError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'RdapNotFoundError';\n  }\n}\n","import { RdapAutnumResponse, RdapDomainResponse, RdapIpResponse } from './types';\nimport { DefaultFetcher, Fetcher } from './utils/fetcher';\nimport { RdapNotFoundError } from './utils/throwables';\n\nexport interface RdapClientOptions {\n  fetcher?: Fetcher;\n  baseDomain?: string;\n}\n\nexport class RdapClient {\n  private readonly fetcher: Fetcher;\n  private readonly baseDomain: string;\n\n  constructor(options: RdapClientOptions = {}) {\n    this.fetcher = options.fetcher ?? new DefaultFetcher();\n    this.baseDomain = options.baseDomain ?? 'www.rdap.net';\n  }\n\n  /**\n   * Convert domain to punycode if needed\n   */\n  private prepareDomain(domain: string): string {\n    return domain\n      .toLowerCase()\n      .split('.')\n      .map((part) => {\n        try {\n          if (part.includes('xn--')) {\n            return part;\n          }\n          // Use URL API to handle IDN conversion\n          const url = new URL(`https://${part}`);\n          return url.hostname.startsWith('xn--') ? url.hostname : part;\n        } catch {\n          return part;\n        }\n      })\n      .join('.');\n  }\n\n  /**\n   * Query domain information\n   * @param domain Domain name to query (supports IDN/punycode)\n   * @returns Domain information\n   * @example\n   * ```typescript\n   * const client = new RdapClient();\n   * const domain = await client.domain('example.com');\n   * // IDN support\n   * const idn = await client.domain('münchen.de');\n   * ```\n   */\n  async domain(domain: string): Promise<RdapDomainResponse> {\n    const punyDomain = this.prepareDomain(domain);\n    const url = `https://${this.baseDomain}/domain/${encodeURIComponent(punyDomain)}`;\n    const response = await this.fetcher.fetch<never, RdapDomainResponse>({\n      method: 'GET',\n      url,\n    });\n\n    if (response.status === 404 && response.url === url) {\n      throw new RdapNotFoundError(`Domain ${domain} has no RDAP server for its TLD`);\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Query IP address or network information\n   * @param ip IP address or CIDR notation\n   * @returns IP network information\n   * @example\n   * ```typescript\n   * const client = new RdapClient();\n   * const ip = await client.ip('8.8.8.8');\n   * // or with CIDR notation\n   * const network = await client.ip('2001:db8::1/128');\n   * ```\n   */\n  async ip(ip: string): Promise<RdapIpResponse> {\n    const response = await this.fetcher.fetch<never, RdapIpResponse>({\n      method: 'GET',\n      url: `https://${this.baseDomain}/ip/${encodeURIComponent(ip)}`,\n    });\n\n    return response.data;\n  }\n\n  /**\n   * Query Autonomous System Number information\n   * @param asn Autonomous System Number\n   * @returns ASN information\n   * @example\n   * ```typescript\n   * const client = new RdapClient();\n   * const asn = await client.autnum(174);\n   * ```\n   */\n  async autnum(asn: number): Promise<RdapAutnumResponse> {\n    const response = await this.fetcher.fetch<never, RdapAutnumResponse>({\n      method: 'GET',\n      url: `https://${this.baseDomain}/autnum/${asn}`,\n    });\n\n    return response.data;\n  }\n}\n"],"mappings":";AAqCO,IAAM,iBAAN,MAAwC;AAAA,EAC7C,MAAM,MAA4C;AAAA,IAChD;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU,CAAC;AAAA,EACb,GAA2D;AACzD,UAAM,aAAa,IAAI,IAAI,GAAG;AAG9B,QAAI,WAAW,SAAS,MAAM;AAC5B,aAAO,QAAQ,IAA8B,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACvE,mBAAW,aAAa,OAAO,KAAK,KAAK;AAAA,MAC3C,CAAC;AAAA,IACH;AAEA,UAAM,cAA2B;AAAA,MAC/B;AAAA,MACA,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,MACL;AAAA,IACF;AAGA,QAAI,WAAW,SAAS,MAAM;AAC5B,kBAAY,OAAO,KAAK,UAAU,IAAI;AAAA,IACxC;AAEA,UAAM,WAAW,MAAM,MAAM,YAAY,WAAW;AACpD,UAAM,OAAQ,MAAM,SAAS,KAAK;AAElC,WAAO;AAAA,MACL,QAAQ,SAAS;AAAA,MACjB;AAAA,MACA,SAAS,SAAS;AAAA,MAClB,KAAK,SAAS;AAAA,IAChB;AAAA,EACF;AACF;;;AC5EO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;ACIO,IAAM,aAAN,MAAiB;AAAA,EAItB,YAAY,UAA6B,CAAC,GAAG;AAC3C,SAAK,UAAU,QAAQ,WAAW,IAAI,eAAe;AACrD,SAAK,aAAa,QAAQ,cAAc;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,QAAwB;AAC5C,WAAO,OACJ,YAAY,EACZ,MAAM,GAAG,EACT,IAAI,CAAC,SAAS;AACb,UAAI;AACF,YAAI,KAAK,SAAS,MAAM,GAAG;AACzB,iBAAO;AAAA,QACT;AAEA,cAAM,MAAM,IAAI,IAAI,WAAW,IAAI,EAAE;AACrC,eAAO,IAAI,SAAS,WAAW,MAAM,IAAI,IAAI,WAAW;AAAA,MAC1D,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF,CAAC,EACA,KAAK,GAAG;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,OAAO,QAA6C;AACxD,UAAM,aAAa,KAAK,cAAc,MAAM;AAC5C,UAAM,MAAM,WAAW,KAAK,UAAU,WAAW,mBAAmB,UAAU,CAAC;AAC/E,UAAM,WAAW,MAAM,KAAK,QAAQ,MAAiC;AAAA,MACnE,QAAQ;AAAA,MACR;AAAA,IACF,CAAC;AAED,QAAI,SAAS,WAAW,OAAO,SAAS,QAAQ,KAAK;AACnD,YAAM,IAAI,kBAAkB,UAAU,MAAM,iCAAiC;AAAA,IAC/E;AAEA,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,GAAG,IAAqC;AAC5C,UAAM,WAAW,MAAM,KAAK,QAAQ,MAA6B;AAAA,MAC/D,QAAQ;AAAA,MACR,KAAK,WAAW,KAAK,UAAU,OAAO,mBAAmB,EAAE,CAAC;AAAA,IAC9D,CAAC;AAED,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,OAAO,KAA0C;AACrD,UAAM,WAAW,MAAM,KAAK,QAAQ,MAAiC;AAAA,MACnE,QAAQ;AAAA,MACR,KAAK,WAAW,KAAK,UAAU,WAAW,GAAG;AAAA,IAC/C,CAAC;AAED,WAAO,SAAS;AAAA,EAClB;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chez14/rdap-sdk",
-  "version": "0.1.1-5",
+  "version": "0.1.1-8",
   "description": "A TypeScript SDK for RDAP.net. Directly calls RDAP APIs from RDAP.net as the main RDAP Server Database.",
   "repository": {
     "type": "git",

package/src/client.ts

@@ -1,7 +1,8 @@
-import { AutonomousSystemResponse, DomainResponse, IpNetworkResponse } from './types';
+import { RdapAutnumResponse, RdapDomainResponse, RdapIpResponse } from './types';
 import { DefaultFetcher, Fetcher } from './utils/fetcher';
+import { RdapNotFoundError } from './utils/throwables';
 
-export interface RdapOrgClientOptions {
+export interface RdapClientOptions {
   fetcher?: Fetcher;
   baseDomain?: string;
 }
@@ -10,7 +11,7 @@ export class RdapClient {
   private readonly fetcher: Fetcher;
   private readonly baseDomain: string;
 
-  constructor(options: RdapOrgClientOptions = {}) {
+  constructor(options: RdapClientOptions = {}) {
     this.fetcher = options.fetcher ?? new DefaultFetcher();
     this.baseDomain = options.baseDomain ?? 'www.rdap.net';
   }
@@ -43,19 +44,24 @@ export class RdapClient {
    * @returns Domain information
    * @example
    * ```typescript
-   * const client = new RdapOrgClient();
+   * const client = new RdapClient();
    * const domain = await client.domain('example.com');
    * // IDN support
    * const idn = await client.domain('münchen.de');
    * ```
    */
-  async domain(domain: string): Promise<DomainResponse> {
+  async domain(domain: string): Promise<RdapDomainResponse> {
     const punyDomain = this.prepareDomain(domain);
-    const response = await this.fetcher.fetch<never, DomainResponse>({
+    const url = `https://${this.baseDomain}/domain/${encodeURIComponent(punyDomain)}`;
+    const response = await this.fetcher.fetch<never, RdapDomainResponse>({
       method: 'GET',
-      url: `https://${this.baseDomain}/domain/${encodeURIComponent(punyDomain)}`,
+      url,
     });
 
+    if (response.status === 404 && response.url === url) {
+      throw new RdapNotFoundError(`Domain ${domain} has no RDAP server for its TLD`);
+    }
+
     return response.data;
   }
 
@@ -65,14 +71,14 @@ export class RdapClient {
    * @returns IP network information
    * @example
    * ```typescript
-   * const client = new RdapOrgClient();
+   * const client = new RdapClient();
    * const ip = await client.ip('8.8.8.8');
    * // or with CIDR notation
    * const network = await client.ip('2001:db8::1/128');
    * ```
    */
-  async ip(ip: string): Promise<IpNetworkResponse> {
-    const response = await this.fetcher.fetch<never, IpNetworkResponse>({
+  async ip(ip: string): Promise<RdapIpResponse> {
+    const response = await this.fetcher.fetch<never, RdapIpResponse>({
       method: 'GET',
       url: `https://${this.baseDomain}/ip/${encodeURIComponent(ip)}`,
     });
@@ -86,12 +92,12 @@ export class RdapClient {
    * @returns ASN information
    * @example
    * ```typescript
-   * const client = new RdapOrgClient();
+   * const client = new RdapClient();
    * const asn = await client.autnum(174);
    * ```
    */
-  async autnum(asn: number): Promise<AutonomousSystemResponse> {
-    const response = await this.fetcher.fetch<never, AutonomousSystemResponse>({
+  async autnum(asn: number): Promise<RdapAutnumResponse> {
+    const response = await this.fetcher.fetch<never, RdapAutnumResponse>({
       method: 'GET',
       url: `https://${this.baseDomain}/autnum/${asn}`,
     });

package/src/types.ts

@@ -1,55 +1,216 @@
-/**
- * Base response interface for RDAP queries
+/*
+ * These files were copied directly from
+ * https://github.com/dcoffey-zengenti/node-rdap/blob/aa294812f01730f3ce5f1c384fb92cfbfeaf846f/src/types.ts.
  */
-export interface RdapResponse {
-  rdapConformance: string[];
-  notices?: Array<{
-    title?: string;
-    description: string[];
-    links?: Array<{
-      value: string;
-      rel: string;
-      href: string;
-      type?: string;
-    }>;
-  }>;
-}
-
-/**
- * Domain response interface
- */
-export interface DomainResponse extends RdapResponse {
+
+export interface RdapLink {
+  value: string;
+  rel: string;
+  href: string;
+  hreflang?: string[];
+  type?: string;
+  media?: string;
+  title?: string;
+}
+
+export interface RdapEvent {
+  eventAction: string;
+  eventActor?: string;
+  eventDate: string;
+  links?: RdapLink[];
+}
+
+export interface RdapPublicID {
+  type: string;
+  identifier: string;
+}
+
+export type RdapStatus =
+  | 'validated'
+  | 'renew prohibited'
+  | 'update prohibited'
+  | 'transfer prohibited'
+  | 'delete prohibited'
+  | 'proxy'
+  | 'private'
+  | 'removed'
+  | 'obscured'
+  | 'associated'
+  | 'active'
+  | 'inactive'
+  | 'locked'
+  | 'pending create'
+  | 'pending renew'
+  | 'pending transfer'
+  | 'pending update'
+  | 'pending delete';
+
+export type RdapNoticeAndRemarkTypes =
+  | 'result set truncated due to authorization'
+  | 'result set truncated due to excessive load'
+  | 'result set truncated due to unexplainable reasons'
+  | 'object truncated due to authorization'
+  | 'object truncated due to excessive load'
+  | 'object truncated due to unexplainable reasons';
+
+export interface RdapRemark {
+  title?: string;
+  type?: RdapNoticeAndRemarkTypes;
+  description: string[];
+  links?: RdapLink[];
+}
+
+export interface RdapDsData {
+  keyTag?: number;
+  algorithm?: number;
+  digest?: string;
+  digestType?: string;
+  events?: RdapEvent[];
+  links?: RdapLink[];
+}
+
+export interface RdapKeyData {
+  flags?: number;
+  protocol?: number;
+  publicKey?: string;
+  algorithm?: number;
+  events?: RdapEvent[];
+  links?: RdapLink[];
+}
+
+export interface RdapSecureDNS {
+  zoneSigned?: boolean;
+  delegationSigned?: boolean;
+  maxSigLife?: number;
+  dsData?: RdapDsData[];
+  keyData?: RdapKeyData[];
+}
+
+export type RdapNotice = RdapRemark;
+
+export type RdapObjectClass =
+  | RdapEntityObjectClass
+  | RdapNameserverObjectClass
+  | RdapDomainObjectClass;
+
+export interface RdapEntityObjectClass {
+  objectClassName: 'entity';
+  handle?: string;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  vcardArray?: any[];
+  roles?: string[];
+  publicIds?: RdapPublicID[];
+  entities?: RdapEntityObjectClass[];
+  remarks?: RdapRemark[];
+  links?: RdapLink[];
+  events?: RdapEvent[];
+  asEventActor?: Omit<RdapEvent, 'eventActor'>[];
+  status?: RdapStatus[];
+  port43?: string;
+  networks?: RdapIPNetworkObjectClass[];
+  autnums?: RdapAutonomousSystemNumberObjectClass[];
+}
+
+export interface RdapNameserverObjectClass {
+  objectClassName: 'nameserver';
+  handle?: string;
+  ldhName?: string;
+  unicodeName?: string;
+  ipAddresses?: {
+    v6: string[];
+    v4: string[];
+  };
+  entities?: RdapEntityObjectClass[];
+  status?: RdapStatus[];
+  remarks?: RdapRemark[];
+  links?: RdapLink[];
+  port43?: string;
+  events?: RdapEvent[];
+}
+
+export interface RdapDomainObjectClass {
   objectClassName: 'domain';
   handle?: string;
-  ldhName: string;
-  links: Array<{
-    rel: string;
-    href: string;
-    type?: string;
-  }>;
+  ldhName?: string;
+  unicodeName?: string;
+  variants: {
+    relation: string[];
+    idnTable: string;
+    variantName: {
+      ldhName: string;
+      unicodeName: string;
+    }[];
+  }[];
+  nameservers: RdapNameserverObjectClass[];
+  secureDNS: RdapSecureDNS;
+  entities?: RdapEntityObjectClass[];
+  status?: RdapStatus[];
+  publicIds?: RdapPublicID[];
+  remarks: RdapRemark[];
+  links?: RdapLink[];
+  port43?: string;
+  events?: RdapEvent[];
+  network?: RdapIPNetworkObjectClass;
 }
 
-/**
- * IP Network response interface
- */
-export interface IpNetworkResponse extends RdapResponse {
+export interface RdapIPNetworkObjectClass {
   objectClassName: 'ip network';
-  handle: string;
-  startAddress: string;
-  endAddress: string;
-  ipVersion: string;
+  handle?: string;
+  startAddress?: string;
+  endAddress?: string;
+  ipVersion?: 'v4' | 'v6';
   name?: string;
   type?: string;
+  country?: string;
+  parentHandle?: string;
+  status?: RdapStatus[];
+  entities?: RdapEntityObjectClass[];
+  remarks: RdapRemark[];
+  links?: RdapLink[];
+  port43?: string;
+  events?: RdapEvent[];
 }
 
-/**
- * Autonomous System Number response interface
- */
-export interface AutonomousSystemResponse extends RdapResponse {
+export interface RdapAutonomousSystemNumberObjectClass {
   objectClassName: 'autnum';
-  handle: string;
-  startAutnum: number;
-  endAutnum: number;
+  handle?: string;
+  startAutnum?: string;
+  endAutnum?: string;
   name?: string;
   type?: string;
+  status?: RdapStatus[];
+  country?: string;
+  entities?: RdapEntityObjectClass[];
+  remarks: RdapRemark[];
+  links?: RdapLink[];
+  port43?: string;
+  events?: RdapEvent[];
+}
+
+export interface RdapDomainSuccessResponse extends RdapDomainObjectClass {
+  rdapConformance: string[];
 }
+
+export interface RdapIpSuccessResponse extends RdapIPNetworkObjectClass {
+  rdapConformance: string[];
+}
+
+export interface RdapAutnumSuccessResponse extends RdapAutonomousSystemNumberObjectClass {
+  rdapConformance: string[];
+}
+
+export interface RdapHelpSuccessResponse {
+  rdapConformance: string[];
+  notices?: RdapNotice[];
+}
+
+export interface RdapErrorResponse {
+  errorCode: number;
+  title?: string;
+  description?: string[];
+}
+
+export type RdapDomainResponse = RdapErrorResponse & RdapDomainSuccessResponse;
+export type RdapIpResponse = RdapErrorResponse & RdapIpSuccessResponse;
+export type RdapAutnumResponse = RdapErrorResponse & RdapAutnumSuccessResponse;
+export type RdapHelpResponse = RdapErrorResponse & RdapHelpSuccessResponse;

package/src/utils/fetcher.ts

@@ -20,6 +20,7 @@ export interface FetchResponse<T = unknown> {
   status: number;
   data: T;
   headers: Headers;
+  url: string;
 }
 
 /**
@@ -70,6 +71,7 @@ export class DefaultFetcher implements Fetcher {
       status: response.status,
       data,
       headers: response.headers,
+      url: response.url,
     };
   }
 }

package/src/utils/throwables.ts

@@ -0,0 +1,6 @@
+export class RdapNotFoundError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'RdapNotFoundError';
+  }
+}