@stacksjs/whois 0.70.54 → 0.70.55

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/whois",
   "type": "module",
-  "version": "0.70.54",
+  "version": "0.70.55",
   "description": "Easily get whois info.",
   "author": "Chris Breuer",
   "contributors": [
@@ -41,7 +41,8 @@
   "types": "./dist/index.d.ts",
   "files": [
     "README.md",
-    "dist"
+    "dist",
+    "src"
   ],
   "scripts": {
     "build": "bun build.ts",

package/src/constants.ts

@@ -0,0 +1,325 @@
+export const IANA_CHK_URL: string = 'https://www.iana.org/whois?q='
+
+export const PARAMETERS: Record<string, string> = {
+  'whois.denic.de': '-T dn,ace',
+  'whois.nic.fr': '-V Md5.2',
+}
+
+export const SERVERS: Record<string, string> = {
+  'br.com': 'whois.centralnic.net',
+  'cn.com': 'whois.centralnic.net',
+  'de.com': 'whois.centralnic.net',
+  'eu.com': 'whois.centralnic.net',
+  'gb.com': 'whois.centralnic.net',
+  'gb.net': 'whois.centralnic.net',
+  'gr.com': 'whois.centralnic.net',
+  'hu.com': 'whois.centralnic.net',
+  'in.net': 'whois.centralnic.net',
+  'no.com': 'whois.centralnic.net',
+  'qc.com': 'whois.centralnic.net',
+  'ru.com': 'whois.centralnic.net',
+  'sa.com': 'whois.centralnic.net',
+  'se.com': 'whois.centralnic.net',
+  'se.net': 'whois.centralnic.net',
+  'uk.com': 'whois.centralnic.net',
+  'uk.net': 'whois.centralnic.net',
+  'us.com': 'whois.centralnic.net',
+  'uy.com': 'whois.centralnic.net',
+  'za.com': 'whois.centralnic.net',
+  'jpn.com': 'whois.centralnic.ne',
+  'web.com': 'whois.centralnic.ne',
+  'com': 'whois.verisign-grs.com',
+  'za.net': 'whois.za.net',
+  'net': 'whois.verisign-grs.com',
+  'eu.org': 'whois.eu.org',
+  'za.org': 'whois.za.org',
+  'org': 'whois.pir.org',
+  'llyw.cymru': 'whois.nic.llyw.cymru',
+  'gov.scot': 'whois.nic.gov.scot',
+  'gov.wales': 'whois.nic.gov.wales',
+  'edu': 'whois.educause.edu',
+  'gov': 'whois.dotgov.gov',
+  'int': 'whois.iana.org',
+  'e164.arpa': 'whois.ripe.net',
+  'arpa': 'whois.iana.org',
+  'aero': 'whois.aero',
+  'asia': 'whois.nic.asia',
+  'biz': 'whois.nic.biz',
+  'cat': 'whois.nic.cat',
+  'coop': 'whois.nic.coop',
+  'info': 'whois.afilias.net',
+  'jobs': 'whois.nic.jobs',
+  'mobi': 'whois.afilias.net',
+  'museum': 'whois.nic.museum',
+  'name': 'whois.nic.name',
+  'post': 'whois.dotpostregistry.net',
+  'pro': 'whois.nic.pro',
+  'tel': 'whois.nic.tel',
+  'travel': 'whois.nic.travel',
+  'xxx': 'whois.nic.xxx',
+  'ac': 'whois.nic.ac',
+  'ae': 'whois.aeda.net.ae',
+  'af': 'whois.nic.af',
+  'ag': 'whois.nic.ag',
+  'ai': 'whois.nic.ai',
+  'am': 'whois.amnic.net',
+  'ar': 'whois.nic.ar',
+  'as': 'whois.nic.as',
+  'priv.at': 'whois.nic.priv.at',
+  'at': 'whois.nic.at',
+  'au': 'whois.auda.org.au',
+  'aw': 'whois.nic.aw',
+  'ax': 'whois.ax',
+  'be': 'whois.dns.be',
+  'bf': 'whois.registre.bf',
+  'bg': 'whois.register.bg',
+  'bh': 'whois.nic.bh',
+  'bi': 'whois1.nic.bi',
+  'bj': 'whois.nic.bj',
+  'bm': 'whois.afilias-srs.net',
+  'bn': 'whois.bnnic.bn',
+  'bo': 'whois.nic.bo',
+  'br': 'whois.registro.br',
+  'by': 'whois.cctld.by',
+  'bw': 'whois.nic.net.bw',
+  'bz': 'whois.afilias-grs.info',
+  'co.ca': 'whois.co.ca',
+  'ca': 'whois.cira.ca',
+  'cc': 'ccwhois.verisign-grs.com',
+  'cd': 'whois.nic.cd',
+  'ch': 'whois.nic.ch',
+  'ci': 'whois.nic.ci',
+  'cl': 'whois.nic.cl',
+  'cm': 'whois.netcom.cm',
+  'edu.cn': 'whois.edu.cn',
+  'cn': 'whois.cnnic.cn',
+  'uk.co': 'whois.uk.co',
+  'co': 'whois.nic.co',
+  'cr': 'whois.nic.cr',
+  'cx': 'whois.nic.cx',
+  'cz': 'whois.nic.cz',
+  'de': 'whois.denic.de',
+  'dk': 'whois.dk-hostmaster.dk',
+  'dm': 'whois.dmdomains.dm',
+  'do': 'whois.nic.do',
+  'dz': 'whois.nic.dz',
+  'ec': 'whois.nic.ec',
+  'ee': 'whois.tld.ee',
+  'eu': 'whois.eu',
+  'fi': 'whois.fi',
+  'fj': 'www.whois.fj',
+  'fm': 'whois.nic.fm',
+  'fo': 'whois.nic.fo',
+  'fr': 'whois.nic.fr',
+  'gd': 'whois.nic.gd',
+  'ge': 'whois.nic.ge',
+  'gf': 'whois.mediaserv.net',
+  'gg': 'whois.gg',
+  'gh': 'whois.nic.gh',
+  'gi': 'whois2.afilias-grs.net',
+  'gl': 'whois.nic.gl',
+  'gp': 'whois.nic.gp',
+  'gq': 'whois.dominio.gq',
+  'gs': 'whois.nic.gs',
+  'gy': 'whois.registry.gy',
+  'hk': 'whois.hkirc.hk',
+  'hm': 'whois.registry.hm',
+  'hn': 'whois.nic.hn',
+  'hr': 'whois.dns.hr',
+  'ht': 'whois.nic.ht',
+  'hu': 'whois.nic.hu',
+  'id': 'whois.id',
+  'ie': 'whois.weare.ie',
+  'il': 'whois.isoc.org.il',
+  'im': 'whois.nic.im',
+  'in': 'whois.registry.in',
+  'io': 'whois.nic.io',
+  'iq': 'whois.cmc.iq',
+  'ir': 'whois.nic.ir',
+  'is': 'whois.isnic.is',
+  'it': 'whois.nic.it',
+  'je': 'whois.je',
+  'jp': 'whois.jprs.jp',
+  'ke': 'whois.kenic.or.ke',
+  'kg': 'whois.kg',
+  'ki': 'whois.nic.ki',
+  'kn': 'whois.nic.kn',
+  'kr': 'whois.kr',
+  'kw': 'whois.nic.kw',
+  'ky': 'whois.kyregistry.ky',
+  'kz': 'whois.nic.kz',
+  'la': 'whois.nic.la',
+  'lb': 'whois.lbdr.org.lb',
+  'lc': 'whois2.afilias-grs.net',
+  'li': 'whois.nic.li',
+  'lk': 'whois.nic.lk',
+  'ls': 'whois.nic.ls',
+  'lt': 'whois.domreg.lt',
+  'lu': 'whois.dns.lu',
+  'lv': 'whois.nic.lv',
+  'ly': 'whois.nic.ly',
+  'ma': 'whois.registre.ma',
+  'md': 'whois.nic.md',
+  'me': 'whois.nic.me',
+  'mg': 'whois.nic.mg',
+  'mk': 'whois.marnet.mk',
+  'ml': 'whois.dot.ml',
+  'mm': 'whois.registry.gov.mm',
+  'mn': 'whois.nic.mn',
+  'mq': 'whois.mediaserv.net',
+  'mr': 'whois.nic.mr',
+  'ms': 'whois.nic.ms',
+  'mt': 'whois.nic.org.mt',
+  'mu': 'whois.nic.mu',
+  'mw': 'whois.nic.mw',
+  'mx': 'whois.mx',
+  'my': 'whois.mynic.my',
+  'mz': 'whois.nic.mz',
+  'na': 'whois.na-nic.com.na',
+  'nc': 'whois.nc',
+  'nf': 'whois.nic.nf',
+  'ng': 'whois.nic.net.ng',
+  'nl': 'whois.domain-registry.nl',
+  'no': 'whois.norid.no',
+  'nu': 'whois.iis.nu',
+  'nz': 'whois.irs.net.nz',
+  'om': 'whois.registry.om',
+  'pe': 'kero.yachay.pe',
+  'pf': 'whois.registry.pf',
+  'pk': 'whois.pknic.net.pk',
+  'co.pl': 'whois.co.pl',
+  'pl': 'whois.dns.pl',
+  'pm': 'whois.nic.pm',
+  'pr': 'whois.afilias-srs.net',
+  'ps': 'whois.pnina.ps',
+  'pt': 'whois.dns.pt',
+  'pw': 'whois.nic.pw',
+  'qa': 'whois.registry.qa',
+  're': 'whois.nic.re',
+  'ro': 'whois.rotld.ro',
+  'rs': 'whois.rnids.rs',
+  'ac.ru': 'whois.free.net',
+  'edu.ru': 'whois.informika.ru',
+  'com.ru': 'whois.flexireg.net',
+  'msk.ru': 'whois.flexireg.net',
+  'net.ru': 'whois.nic.net.ru',
+  'nov.ru': 'whois.flexireg.net',
+  'org.ru': 'whois.nic.net.ru',
+  'pp.ru': 'whois.nic.net.ru',
+  'spb.ru': 'whois.flexireg.net',
+  'ru': 'whois.tcinet.ru',
+  'rw': 'whois.ricta.org.rw',
+  'sa': 'whois.nic.net.sa',
+  'sb': 'whois.nic.net.sb',
+  'sc': 'whois2.afilias-grs.net',
+  'sd': 'whois.sdnic.sd',
+  'se': 'whois.iis.se',
+  'sg': 'whois.sgnic.sg',
+  'sh': 'whois.nic.sh',
+  'si': 'whois.register.si',
+  'sk': 'whois.sk-nic.sk',
+  'sl': 'whois.nic.sl',
+  'sm': 'whois.nic.sm',
+  'sn': 'whois.nic.sn',
+  'so': 'whois.nic.so',
+  'ss': 'whois.nic.ss',
+  'st': 'whois.nic.st',
+  'msk.su': 'whois.flexireg.net',
+  'nov.su': 'whois.flexireg.net',
+  'spb.su': 'whois.flexireg.net',
+  'su': 'whois.tcinet.ru',
+  'sx': 'whois.sx',
+  'sy': 'whois.tld.sy',
+  'tc': 'whois.nic.tc',
+  'td': 'whois.nic.td',
+  'tf': 'whois.nic.tf',
+  'tg': 'whois.nic.tg',
+  'th': 'whois.thnic.co.th',
+  'tk': 'whois.dot.tk',
+  'tl': 'whois.nic.tl',
+  'tm': 'whois.nic.tm',
+  'tn': 'whois.ati.tn',
+  'to': 'whois.tonic.to',
+  'tr': 'whois.trabis.gov.tr',
+  'tv': 'whois.nic.tv',
+  'tw': 'whois.twnic.net.tw',
+  'tz': 'whois.tznic.or.tz',
+  'biz.ua': 'whois.biz.ua',
+  'co.ua': 'whois.co.ua',
+  'pp.ua': 'whois.pp.ua',
+  'ua': 'whois.ua',
+  'ug': 'whois.co.ug',
+  'ac.uk': 'whois.nic.ac.uk',
+  'gov.uk': 'whois.gov.uk',
+  'uk': 'whois.nic.uk',
+  'fed.us': 'whois.nic.gov',
+  'us': 'whois.nic.us',
+  'uy': 'whois.nic.org.uy',
+  'uz': 'whois.cctld.uz',
+  'vc': 'whois2.afilias-grs.net',
+  've': 'whois.nic.ve',
+  'vg': 'whois.nic.vg',
+  'vu': 'whois.dnrs.vu',
+  'wf': 'whois.nic.wf',
+  'ws': 'whois.website.ws',
+  'yt': 'whois.nic.yt',
+  'ac.za': 'whois.ac.za',
+  'co.za': 'whois.registry.net.za',
+  'gov.za': 'whois.gov.za',
+  'net.za': 'net-whois.registry.net.za',
+  'org.za': 'org-whois.registry.net.za',
+  'web.za': 'web-whois.registry.net.za',
+  'zm': 'whois.zicta.zm',
+  'xn--2scrj9c': 'whois.registry.in',
+  'xn--3e0b707e': 'whois.kr',
+  'xn--3hcrj9c': 'whois.registry.in',
+  'xn--45br5cyl': 'whois.registry.in',
+  'xn--45brj9c': 'whois.registry.in',
+  'xn--4dbrk0ce': 'whois.isoc.org.il',
+  'xn--80ao21a': 'whois.nic.kz',
+  'xn--90a3ac': 'whois.rnids.rs',
+  'xn--90ae': 'whois.imena.bg',
+  'xn--90ais': 'whois.cctld.by',
+  'xn--clchc0ea0b2g2a9gcd': 'whois.sgnic.sg',
+  'xn--d1alf': 'whois.marnet.mk',
+  'xn--e1a4c': 'whois.eu',
+  'xn--fiqs8s': 'cwhois.cnnic.cn',
+  'xn--fiqz9s': 'cwhois.cnnic.cn',
+  'xn--fpcrj9c3d': 'whois.registry.in',
+  'xn--fzc2c9e2c': 'whois.nic.lk',
+  'xn--gecrj9c': 'whois.registry.in',
+  'xn--h2breg3eve': 'whois.registry.in',
+  'xn--h2brj9c8c': 'whois.registry.in',
+  'xn--h2brj9c': 'whois.registry.in',
+  'xn--j1amh': 'whois.dotukr.com',
+  'xn--j6w193g': 'whois.hkirc.hk',
+  'xn--kprw13d': 'whois.twnic.net.tw',
+  'xn--kpry57d': 'whois.twnic.net.tw',
+  'xn--lgbbat1ad8j': 'whois.nic.dz',
+  'xn--mgb9awbf': 'whois.registry.om',
+  'xn--mgba3a4f16a': 'whois.nic.ir',
+  'xn--mgbaam7a8h': 'whois.aeda.net.ae',
+  'xn--mgbah1a3hjkrd': 'whois.nic.mr',
+  'xn--mgbbh1a71e': 'whois.registry.in',
+  'xn--mgbbh1a': 'whois.registry.in',
+  'xn--mgberp4a5d4ar': 'whois.nic.net.sa',
+  'xn--mgbgu82a': 'whois.registry.in',
+  'xn--mgbtx2b': 'whois.cmc.iq',
+  'xn--mgbx4cd0ab': 'whois.mynic.my',
+  'xn--node': 'whois.itdc.ge',
+  'xn--o3cw4h': 'whois.thnic.co.th',
+  'xn--ogbpf8fl': 'whois.tld.sy',
+  'xn--p1ai': 'whois.tcinet.ru',
+  'xn--pgbs0dh': 'whois.ati.tn',
+  'xn--q7ce6a': 'whois.nic.la',
+  'xn--qxa6a': 'whois.eu',
+  'xn--rvc1e0am3e': 'whois.registry.in',
+  'xn--s9brj9c': 'whois.registry.in',
+  'xn--wgbh1c': 'whois.dotmasr.eg',
+  'xn--wgbl6a': 'whois.registry.qa',
+  'xn--xkc2al3hye2a': 'whois.nic.lk',
+  'xn--xkc2dl3a5ee0h': 'whois.registry.in',
+  'xn--y9a3aq': 'whois.amnic.net',
+  'xn--yfro4i67o': 'whois.sgnic.sg',
+  'xn--ygbi2ammx': 'whois.pnina.ps',
+}

package/src/index.ts

@@ -0,0 +1,395 @@
+import type { ProxyData, WhoIsOptions, WhoIsResponse } from './types'
+import Net from 'node:net'
+import { log } from '@stacksjs/logging'
+import { IANA_CHK_URL, PARAMETERS, SERVERS } from './constants'
+import { SocksClient } from './socks'
+import type { SocksClientOptions } from './socks'
+import { ProxyType } from './types'
+import { shallowCopy } from './utils'
+
+/**
+ * Find the WhoIs server for the TLD from IANA WhoIs service. The TLD is be searched and the HTML response is parsed to extract the WhoIs server
+ *
+ * @param tld TLD of the domain
+ * @returns WhoIs server which hosts the information for the domains of the TLD
+ */
+export async function findWhoIsServer(tld: string): Promise<string> {
+  const chkURL = IANA_CHK_URL + tld
+
+  try {
+    const res = await fetch(chkURL)
+    if (res.ok) {
+      const body = await res.text()
+      const server = body.match(/whois:\s+(\S+)/)
+      if (server?.[1])
+        return server[1]
+    }
+  }
+  catch (err) {
+    console.error('Error in getting WhoIs server data from IANA', err)
+  }
+
+  return ''
+}
+
+/**
+ * Get whois server of the tld from servers list
+ *
+ * @param tld TLD of the domain
+ * @returns WhoIs server which hosts the information for the domains of the TLD
+ */
+export function getWhoIsServer(tld: keyof typeof SERVERS): string | undefined {
+  if (tld === 'com')
+    return 'whois.verisign-grs.com'
+  return SERVERS[tld]
+}
+
+/**
+ * Extract TLD from domain name.
+ * If the TLD is in whois-servers.json file, then the TLD is returned.
+ * If TLD is not found within the file, then determined by taking the last element after splitting the domain name from '.'
+ *
+ * @param domain Domain name
+ * @returns TLD
+ */
+export function getTLD(domain: string): keyof typeof SERVERS {
+  const domainParts = domain.split('.')
+  for (let i = domainParts.length - 1; i > 0; i--) {
+    const possibleTLD = domainParts.slice(i).join('.') as keyof typeof SERVERS
+    if (SERVERS[possibleTLD]) {
+      return possibleTLD
+    }
+  }
+  // If no match found in SERVERS, return the last part
+  return domainParts[domainParts.length - 1] as keyof typeof SERVERS
+}
+
+// get whois query parameters if exist on parameters.json for whois server
+export function getParameters(server: string): string | undefined {
+  return (PARAMETERS as { [key: string]: string })[server]
+}
+
+/**
+ * Parse collected raw WhoIs data
+ *
+ * @class
+ */
+export class WhoIsParser {
+  /**
+   * Iterated through the complete text and returns extracted values
+   *
+   * @param rawData raw text from WhoIs server
+   * @param outputData Data which needs to be extracted from the raw text (key/value pairs). Keys are used to extract from raw text and values are filled.
+   * @returns Filled {@link outputData}
+   */
+  private static iterParse(rawData: string, outputData: any) {
+    let lastStr = ''
+    let lastField: string | null = null
+    let lastLetter = ''
+
+    for (let i = 0; i < rawData.length; i++) {
+      const letter = rawData[i]
+      if (letter === '\n' || (lastLetter === ':' && letter === ' ')) {
+        if (lastStr.trim() in outputData) {
+          lastField = lastStr.trim()
+        }
+        else if (lastField !== null) {
+          const x = lastStr.trim()
+          if (x !== '') {
+            const obj = outputData[lastField]
+            if (Array.isArray(obj))
+              obj.push(x)
+            else outputData[lastField] = x
+
+            lastField = null
+          }
+        }
+        lastStr = ''
+      }
+      else if (letter !== ':') {
+        lastStr = lastStr + letter
+      }
+      lastLetter = letter as string
+      if (lastStr === 'Record maintained by' || lastStr === '>>>')
+        break
+    }
+
+    return outputData
+  }
+
+  /**
+   * Parse the raw WhoIs text and returns extracted values
+   *
+   * @param rawData raw text from WhoIs server
+   * @param outputData Data which needs to be extracted from the raw text (key/value pairs). Keys are used to extract from raw text and values are filled.
+   * @returns Filled {@link outputData}
+   */
+  public static parseData(rawData: string, outputData: any | null): any {
+    if (!outputData) {
+      outputData = {
+        'Domain Name': '',
+        'Creation Date': '',
+        'Updated Date': '',
+        'Registry Expiry Date': '',
+        'Domain Status': [],
+        'Registrar': '',
+      }
+    }
+
+    outputData = WhoIsParser.iterParse(rawData, outputData)
+
+    return outputData
+  }
+}
+
+/**
+ * Connects to the provided {@link server}:{@link port} through TCP (through a proxy if a proxy is given), run the WhoIs query and returns the response
+ *
+ * @param domain Domain name
+ * @param queryOptions Query options which can be used with the specific WhoIs server to get the complete response
+ * @param server WhoIs server
+ * @param port WhoIs server port
+ * @param encoding Encoding used by the WhoIs server
+ * @param proxy {@link ProxyData}
+ * @returns The {string} WhoIs response for the query. Empty string is returned for errors
+ */
+export async function tcpWhois(
+  domain: string,
+  queryOptions: string,
+  server: string,
+  port: number,
+  encoding: string,
+  proxy: ProxyData | null,
+): Promise<string> {
+  const decoder = new TextDecoder(encoding)
+  const encoder = new TextEncoder()
+
+  if (!proxy) {
+    const socket = new Net.Socket()
+    // 30s socket timeout — without this, an unresponsive WHOIS server
+    // (or a network partition) leaves the lookup hanging indefinitely
+    // and any caller awaiting it freezes alongside it.
+    socket.setTimeout(30_000)
+    return new Promise((resolve, reject) => {
+      try {
+        socket.connect({ port, host: server }, () => {
+          if (queryOptions !== '')
+            socket.write(encoder.encode(`${queryOptions} ${domain}\r\n`))
+          else socket.write(encoder.encode(`${domain}\r\n`))
+        })
+
+        socket.on('data', (data) => {
+          resolve(decoder.decode(data as any))
+        })
+
+        socket.on('error', (error) => {
+          reject(error)
+        })
+
+        socket.on('timeout', () => {
+          socket.destroy()
+          reject(new Error(`WHOIS request to ${server}:${port} timed out after 30s`))
+        })
+      }
+      catch (e) {
+        reject(e)
+      }
+    })
+  }
+
+  const options: SocksClientOptions = {
+    proxy: {
+      host: proxy.ip,
+      port: proxy.port,
+      type: proxy.type === ProxyType.SOCKS5 ? 5 : 4,
+    },
+
+    command: 'connect',
+
+    destination: {
+      host: server,
+      port,
+    },
+  }
+
+  if (proxy.username && proxy.password) {
+    options.proxy.userId = proxy.username
+    options.proxy.password = proxy.password
+  }
+
+  return new Promise((resolve, reject) => {
+    SocksClient.createConnection(options, (err: any, info: any) => {
+      if (err) {
+        reject(err)
+      }
+      else {
+        if (!info)
+          reject(new Error('No socket info received!'))
+
+        if (queryOptions !== '') {
+          info?.socket.write(encoder.encode(`${queryOptions} ${domain}\r\n`))
+        }
+        else {
+          info?.socket.write(encoder.encode(`${domain}\r\n`))
+        }
+
+        info?.socket.on('data', (data: any) => {
+          resolve(decoder.decode(data as any))
+        })
+
+        info?.socket.resume()
+      }
+    })
+  })
+}
+
+/**
+ * Collect WhoIs data for the mentioned {@link domain}. Parse the received response if {@link parse} is true, accordingly.
+ *
+ * @param domain Domain name
+ * @param parse Whether the raw text needs to be parsed/formatted or not
+ * @param options {@link WhoIsOptions}
+ * @returns {@link WhoIsResponse} Returns a {@link WhoIsResponse} object which contains the raw text and parsed data (if parse is true)
+ */
+export async function whois(
+  domain: string,
+  parse = false,
+  options: WhoIsOptions | null = null,
+): Promise<WhoIsResponse> {
+  let tld: string
+  let port = 43
+  let server = ''
+  let proxy: ProxyData | null
+  let encoding = 'utf-8'
+
+  if (!options) {
+    tld = getTLD(domain)
+    proxy = null
+  }
+  else {
+    tld = options.tld ? options.tld : getTLD(domain)
+    encoding = options.encoding ? options.encoding : 'utf-8'
+    proxy = options.proxy ? options.proxy : null
+    server = options.server ? options.server : ''
+    port = options.serverPort ? options.serverPort : 43
+  }
+
+  if (server === '') {
+    let serverData = getWhoIsServer(tld as keyof typeof SERVERS)
+    if (!serverData) {
+      log.debug(`No WhoIs server found for TLD: ${tld}! Attempting IANA WhoIs database for server!`)
+      serverData = await findWhoIsServer(tld)
+      if (!serverData) {
+        log.debug('WhoIs server could not be found!')
+        return {
+          _raw: '',
+          parsedData: null,
+        }
+      }
+      log.debug(`WhoIs sever found for ${tld}: ${server}`)
+    }
+
+    server = serverData
+  }
+
+  const qOptions = getParameters(server)
+  const queryOptions = qOptions || ''
+
+  try {
+    log.debug(`Attempting WHOIS lookup for ${domain} on server ${server}`)
+    const rawData = await tcpWhois(domain, queryOptions, server, port, encoding, proxy)
+    log.debug(`Raw WHOIS data received:`, rawData)
+    if (!parse) {
+      const parsedData = WhoIsParser.parseData(rawData, null)
+      return {
+        _raw: rawData,
+        parsedData,
+      }
+    }
+
+    let outputData: any | null = null
+    if (options?.parseData)
+      outputData = shallowCopy(options.parseData)
+
+    try {
+      const parsedData = WhoIsParser.parseData(rawData, outputData)
+      return {
+        _raw: rawData,
+        parsedData,
+      }
+    }
+    catch (err) {
+      console.error('Error in parsing WhoIs data!', err)
+      return {
+        _raw: rawData,
+        parsedData: null,
+      }
+    }
+  }
+  catch (err: any) {
+    log.debug(`Error in WHOIS lookup for ${domain} on server ${server}`, err)
+    return {
+      _raw: '',
+      parsedData: null,
+    }
+  }
+}
+
+export function lookup(domain: string, options: WhoIsOptions | null = null): Promise<WhoIsResponse> {
+  log.debug(`Lookup called for ${domain}`)
+  return whois(domain, true, options)
+}
+
+/**
+ * Collects (and parse/format if set to be true) for the provided {@link domains}. If {@link parallel} is set to be true, multiple threads will be used to batch process the domains according to {@link threads} mentioned.
+ * If <i>options.parsedData</i> is mentioned, then it will be used to parse <b>all</b> the responses.
+ * If a proxy is mentioned in {@link options}, then the proxy will be used to collect <b>all</b> the WhoIs data.
+ *
+ * @param domains Domains Names
+ * @param parallel Whether data should be collected parallally or not
+ * @param threads Batch size (for parallel processing)
+ * @param parse Whether the raw text needs to be parsed/formatted or not
+ * @param options {@link WhoIsOptions}
+ * @returns Array of {@link WhoIsResponse} for all the domains. Order is not guaranteed
+ */
+export async function batchWhois(
+  domains: string[],
+  parallel = false,
+  threads = 1,
+  parse = false,
+  options: WhoIsOptions | null = null,
+): Promise<WhoIsResponse[]> {
+  let response: WhoIsResponse[] = []
+
+  if (parallel) {
+    if (threads > domains.length)
+      threads = domains.length
+
+    for (let i = 0; i < domains.length; i += threads) {
+      const batch = domains.slice(i, i + threads)
+      // Accumulate batch results — the previous `response = await Promise.all(...)`
+      // overwrote the array each iteration, so a 100-domain batch with
+      // threads=10 returned only the last 10 entries instead of all 100.
+      const batchResults = await Promise.all(
+        batch.map(async (domain) => {
+          return await whois(domain, parse, options)
+        }),
+      )
+      response.push(...batchResults)
+    }
+  }
+  else {
+    for (let i = 0; i < domains.length; i++) {
+      const res = await whois(domains[i] as string, parse, options)
+      response.push(res)
+    }
+  }
+
+  return response
+}
+
+export * from './constants'
+export * from './types'
+
+export { SocksClient } from './socks'
+export type { SocksClientOptions } from './socks'

package/src/socks.ts

@@ -0,0 +1,331 @@
+/**
+ * Native SOCKS client implementation using Bun's TCP APIs
+ * Replaces the 'socks' npm package
+ */
+
+import Net from 'node:net'
+
+export enum SocksVersion {
+  SOCKS4 = 4,
+  SOCKS5 = 5,
+}
+
+export interface SocksProxy {
+  host: string
+  port: number
+  type: 4 | 5
+  userId?: string
+  password?: string
+}
+
+export interface SocksDestination {
+  host: string
+  port: number
+}
+
+export interface SocksClientOptions {
+  proxy: SocksProxy
+  command: 'connect' | 'bind' | 'associate'
+  destination: SocksDestination
+}
+
+export interface SocksClientEstablishedEvent {
+  socket: Net.Socket
+  remoteHost?: string
+  remotePort?: number
+}
+
+/**
+ * Native SOCKS client implementation
+ */
+export class SocksClient {
+  private options: SocksClientOptions
+
+  constructor(options: SocksClientOptions) {
+    this.options = options
+  }
+
+  /**
+   * Create a SOCKS connection
+   *
+   * @param options SOCKS connection options
+   * @param callback Callback with error or connection info
+   */
+  static createConnection(
+    options: SocksClientOptions,
+    callback: (err: Error | null, info?: SocksClientEstablishedEvent) => void,
+  ): void {
+    const client = new SocksClient(options)
+    client.connect(callback)
+  }
+
+  /**
+   * Establish SOCKS connection
+   */
+  private connect(callback: (err: Error | null, info?: SocksClientEstablishedEvent) => void): void {
+    const socket = new Net.Socket()
+    const { proxy, destination } = this.options
+
+    socket.connect({ port: proxy.port, host: proxy.host }, () => {
+      if (proxy.type === 5) {
+        this.connectSocks5(socket, callback)
+      }
+      else {
+        this.connectSocks4(socket, callback)
+      }
+    })
+
+    socket.on('error', (err) => {
+      callback(err)
+    })
+  }
+
+  /**
+   * SOCKS4 connection handshake
+   */
+  private connectSocks4(socket: Net.Socket, callback: (err: Error | null, info?: SocksClientEstablishedEvent) => void): void {
+    const { destination, proxy } = this.options
+
+    // SOCKS4 request format:
+    // +----+----+----+----+----+----+----+----+----+----+....+----+
+    // | VN | CD | DSTPORT |      DSTIP        | USERID       |NULL|
+    // +----+----+----+----+----+----+----+----+----+----+....+----+
+    //    1    1      2              4           variable       1
+
+    const port = destination.port
+    const userId = proxy.userId || ''
+
+    // Parse IP address
+    let ipBuffer: Buffer
+    if (this.isIPv4(destination.host)) {
+      const parts = destination.host.split('.').map(Number)
+      ipBuffer = Buffer.from(parts)
+    }
+    else {
+      // SOCKS4 doesn't support domain names, use SOCKS4a
+      ipBuffer = Buffer.from([0, 0, 0, 1]) // Special marker for SOCKS4a
+    }
+
+    const request = Buffer.concat([
+      Buffer.from([0x04]), // VN (SOCKS version 4)
+      Buffer.from([0x01]), // CD (CONNECT command)
+      Buffer.from([(port >> 8) & 0xFF, port & 0xFF]), // DSTPORT (2 bytes)
+      ipBuffer, // DSTIP (4 bytes)
+      Buffer.from(userId), // USERID
+      Buffer.from([0x00]), // NULL terminator
+    ])
+
+    // For SOCKS4a with domain name
+    if (!this.isIPv4(destination.host)) {
+      const domainBuffer = Buffer.concat([
+        request,
+        Buffer.from(destination.host),
+        Buffer.from([0x00]), // NULL terminator
+      ])
+      socket.write(domainBuffer)
+    }
+    else {
+      socket.write(request)
+    }
+
+    // Read response
+    socket.once('data', (data) => {
+      // SOCKS4 response format:
+      // +----+----+----+----+----+----+----+----+
+      // | VN | CD | DSTPORT |      DSTIP        |
+      // +----+----+----+----+----+----+----+----+
+      //    1    1      2              4
+
+      if (data.length < 8) {
+        callback(new Error('Invalid SOCKS4 response'))
+        return
+      }
+
+      const status = data[1]
+      if (status !== 0x5A) {
+        // 0x5A = request granted
+        callback(new Error(`SOCKS4 connection failed with status: ${status}`))
+        return
+      }
+
+      callback(null, { socket })
+    })
+  }
+
+  /**
+   * SOCKS5 connection handshake
+   */
+  private connectSocks5(socket: Net.Socket, callback: (err: Error | null, info?: SocksClientEstablishedEvent) => void): void {
+    const { destination, proxy } = this.options
+
+    // Step 1: Authentication method negotiation
+    let authMethods: number[]
+    if (proxy.userId && proxy.password) {
+      authMethods = [0x00, 0x02] // No auth and username/password auth
+    }
+    else {
+      authMethods = [0x00] // No authentication
+    }
+
+    const greeting = Buffer.from([
+      0x05, // SOCKS version
+      authMethods.length, // Number of auth methods
+      ...authMethods,
+    ])
+
+    socket.write(greeting)
+
+    socket.once('data', (data) => {
+      if (data.length < 2 || data[0] !== 0x05) {
+        callback(new Error('Invalid SOCKS5 greeting response'))
+        return
+      }
+
+      const selectedMethod = data[1]
+
+      if (selectedMethod === 0xFF) {
+        callback(new Error('No acceptable authentication methods'))
+        return
+      }
+
+      // Step 2: Authentication (if required)
+      if (selectedMethod === 0x02) {
+        this.authenticateSocks5(socket, callback)
+      }
+      else {
+        this.sendConnectRequest(socket, callback)
+      }
+    })
+  }
+
+  /**
+   * SOCKS5 username/password authentication
+   */
+  private authenticateSocks5(socket: Net.Socket, callback: (err: Error | null, info?: SocksClientEstablishedEvent) => void): void {
+    const { proxy } = this.options
+    const username = proxy.userId || ''
+    const password = proxy.password || ''
+
+    const authRequest = Buffer.concat([
+      Buffer.from([0x01]), // Auth version
+      Buffer.from([username.length]),
+      Buffer.from(username),
+      Buffer.from([password.length]),
+      Buffer.from(password),
+    ])
+
+    socket.write(authRequest)
+
+    socket.once('data', (data) => {
+      if (data.length < 2 || data[0] !== 0x01) {
+        callback(new Error('Invalid SOCKS5 auth response'))
+        return
+      }
+
+      if (data[1] !== 0x00) {
+        callback(new Error('SOCKS5 authentication failed'))
+        return
+      }
+
+      this.sendConnectRequest(socket, callback)
+    })
+  }
+
+  /**
+   * Send SOCKS5 CONNECT request
+   */
+  private sendConnectRequest(socket: Net.Socket, callback: (err: Error | null, info?: SocksClientEstablishedEvent) => void): void {
+    const { destination } = this.options
+    const port = destination.port
+
+    let addressBuffer: Buffer
+    let addressType: number
+
+    if (this.isIPv4(destination.host)) {
+      // IPv4 address
+      addressType = 0x01
+      const parts = destination.host.split('.').map(Number)
+      addressBuffer = Buffer.from(parts)
+    }
+    else if (this.isIPv6(destination.host)) {
+      // IPv6 address
+      addressType = 0x04
+      // Parse IPv6 (simplified)
+      const parts = destination.host.split(':')
+      const bytes: number[] = []
+      for (const part of parts) {
+        const value = Number.parseInt(part, 16)
+        bytes.push((value >> 8) & 0xFF, value & 0xFF)
+      }
+      addressBuffer = Buffer.from(bytes)
+    }
+    else {
+      // Domain name
+      addressType = 0x03
+      addressBuffer = Buffer.concat([
+        Buffer.from([destination.host.length]),
+        Buffer.from(destination.host),
+      ])
+    }
+
+    const request = Buffer.concat([
+      Buffer.from([
+        0x05, // SOCKS version
+        0x01, // CONNECT command
+        0x00, // Reserved
+        addressType, // Address type
+      ]),
+      addressBuffer,
+      Buffer.from([(port >> 8) & 0xFF, port & 0xFF]), // Port (2 bytes)
+    ])
+
+    socket.write(request)
+
+    socket.once('data', (data) => {
+      if (data.length < 10 || data[0] !== 0x05) {
+        callback(new Error('Invalid SOCKS5 connect response'))
+        return
+      }
+
+      const status = data[1]
+      if (status !== 0x00) {
+        const errors: Record<number, string> = {
+          0x01: 'General SOCKS server failure',
+          0x02: 'Connection not allowed by ruleset',
+          0x03: 'Network unreachable',
+          0x04: 'Host unreachable',
+          0x05: 'Connection refused',
+          0x06: 'TTL expired',
+          0x07: 'Command not supported',
+          0x08: 'Address type not supported',
+        }
+        const errorMsg = status === undefined
+          ? 'No SOCKS5 status returned'
+          : (errors as any)[status] || `Unknown error (${status})`
+        callback(new Error(`SOCKS5 connection failed: ${errorMsg}`))
+        return
+      }
+
+      callback(null, { socket })
+    })
+  }
+
+  /**
+   * Check if string is a valid IPv4 address
+   */
+  private isIPv4(address: string): boolean {
+    const ipv4Regex = /^(?:\d{1,3}\.){3}\d{1,3}$/
+    if (!ipv4Regex.test(address))
+      return false
+
+    const parts = address.split('.').map(Number)
+    return parts.every(part => part >= 0 && part <= 255)
+  }
+
+  /**
+   * Check if string is a valid IPv6 address (simplified)
+   */
+  private isIPv6(address: string): boolean {
+    return address.includes(':') && address.split(':').length >= 3
+  }
+}

package/src/types.ts

@@ -0,0 +1,97 @@
+/**
+ * Response returned from whois function. Contains the raw text from WhoIs server and parsed/fornatted WhoIs data (if parsed is true)
+ *
+ * @interface
+ */
+export interface WhoIsResponse {
+  /**
+   * Raw text response from WhoIs server
+   */
+  _raw: string
+  /**
+   * Parsed/Formatted key-value pairs of the response (if parsed is true)
+   */
+  parsedData: any | null
+}
+
+/**
+ * Type of the proxy. Either SOCKS4 or SOCKS5
+ * @enum
+ */
+export enum ProxyType {
+  /**
+   * SOCKS4 type of proxy
+   */
+  SOCKS4 = 0,
+  /**
+   * SOCKS5 type of proxy
+   */
+  SOCKS5 = 1,
+}
+
+/**
+ * Proxy related data
+ * @interface
+ *
+ */
+export interface ProxyData {
+  /**
+   * Proxy IP
+   */
+  ip: string
+  /**
+   * Proxy port
+   */
+  port: number
+  /**
+   * Username to connect to the proxy
+   */
+  username?: string | null
+  /**
+   * Password to connect to the proxy
+   */
+  password?: string | null
+  /**
+   * {@link ProxyType}
+   */
+  type: ProxyType
+}
+
+/**
+ * WhoIs options
+ * @interface
+ */
+export interface WhoIsOptions {
+  /**
+   * TLD of the domain. If the {@link tld} is not provided (or null), then it will be automatically determined as to the given domain name
+   */
+  tld?: string | null
+  /**
+   * The encoding type used for WhoIs server and response. By default UTF-8 is used.
+   */
+  encoding?: string | null
+
+  /** {@link ProxyData} */
+  proxy?: ProxyData | null
+  /**
+   * The WhoIs server to collect data from. If not provided, the server will automatically determined using the {@link tld}
+   */
+  server?: string | null
+  /**
+   * The port of the WhoIs server. By default, port 43 is used.
+   */
+  serverPort?: number | null
+  /**
+   * Which data needs to be extracted/parsed from the WhoIs response.
+   * An object can be passed which contains keys of the fields of the WhoIs response.
+   * A copy of the provided object will be returned with the values filled for the provided keys.
+   *
+   * The keys can have default value of empty string. However, if the WhoIs response has multiple values for the same field (eg: 'Domain Status'),
+   * then all the values can be collected by providing a default value of an Array([]).
+   *
+   * Following example shows an object used to collect 'Domain Name', 'Domain Status' (multiple values) and 'Registrar' from WhoIs response
+   *
+   * @example {'Domain Name': '', 'Domain Status': [], 'Registrar': ''}
+   */
+  parseData?: object | null
+}

package/src/utils.ts

@@ -0,0 +1,22 @@
+/**
+ * Copy an Object with its values
+ *
+ * @param obj Object which needs to be copied
+ * @returns A copy of the object
+ */
+export function shallowCopy<T>(obj: T): T {
+  if (Array.isArray(obj)) {
+    return obj.slice() as T // Clone the array
+  }
+
+  if (typeof obj === 'object' && obj !== null) {
+    const copy: any = {}
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key))
+        copy[key] = shallowCopy(obj[key])
+    }
+    return copy as T
+  }
+
+  return obj // For primitive values, return as is
+}