feat: v0.3.1 — DNS rebinding, AbortController, SWR cache, RDAP extensions, search API, distributed rate limiting, async config validation, usage telemetry, explain(), ESM dual export

New features:
- DNS Rebinding Protection (SSRFProtection.dnsRebinding)
- AbortController support in all query methods (QueryAbortedError)
- Stale-While-Revalidate cache strategy (StaleWhileRevalidateCache)
- RDAP extensions parsing (non-RFC-7483 fields → extensions field)
- RDAP Search API: searchDomains() + searchEntities() (SearchNotSupportedError)
- Distributed Rate Limiting via Redis INCR+PEXPIRE (DistributedRateLimiter)
- Async config validation: client.validate() + validateOnStart option
- Anonymous usage telemetry opt-in (UsageTelemetry, disabled by default)
- client.explain() debug helper (ExplainResult)
- ESM dual export: dist/cjs + dist/esm + dist/types

Tests: 1114 passing

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: vahmo

api-snapshot.json

@@ -11,6 +11,7 @@
   "CompressionManager",
   "ConnectionPool",
   "DenoFetcher",
+  "DistributedRateLimiter",
   "FileAuditAdapter",
   "InMemoryAuditAdapter",
   "InjectRdapClient",
@@ -40,8 +41,10 @@
   "ResponseValidator",
   "RetryStrategy",
   "SSRFProtectionError",
+  "SearchNotSupportedError",
   "TelemetryExporter",
   "TimeoutError",
+  "UsageTelemetry",
   "VERSION",
   "ValidationError",
   "asciiToIdn",

package.json

@@ -1,42 +1,43 @@
 {
   "name": "rdapify",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Unified, secure, high-performance RDAP client with built-in SSRF protection and privacy controls",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.js"
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./worker": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
     },
     "./node": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.js"
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js"
     },
     "./deno": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./worker": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/esm/index.js"
     },
     "./errors": {
-      "types": "./dist/shared/errors/base.error.d.ts",
-      "require": "./dist/shared/errors/base.error.js",
-      "import": "./dist/shared/errors/base.error.js"
+      "types": "./dist/types/shared/errors/base.error.d.ts",
+      "require": "./dist/cjs/shared/errors/base.error.js",
+      "import": "./dist/esm/shared/errors/base.error.js"
     },
     "./types": {
-      "types": "./dist/shared/types/index.d.ts",
-      "require": "./dist/shared/types/index.js",
-      "import": "./dist/shared/types/index.js"
+      "types": "./dist/types/shared/types/index.d.ts",
+      "require": "./dist/cjs/shared/types/index.js",
+      "import": "./dist/esm/shared/types/index.js"
     },
     "./validators": {
-      "types": "./dist/shared/utils/validators/index.d.ts",
-      "require": "./dist/shared/utils/validators/index.js",
-      "import": "./dist/shared/utils/validators/index.js"
+      "types": "./dist/types/shared/utils/validators/index.d.ts",
+      "require": "./dist/cjs/shared/utils/validators/index.js",
+      "import": "./dist/esm/shared/utils/validators/index.js"
     }
   },
   "bin": {
@@ -51,7 +52,10 @@
   ],
   "scripts": {
     "dev": "tsc --watch",
-    "build": "npm run clean && tsc",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types",
     "clean": "rimraf dist",
     "test": "jest --runInBand",
     "test:unit": "jest --testPathPattern=unit",

scripts/verify-api.js

@@ -13,11 +13,14 @@ const __dirname = path.dirname(__filename);
 const require = createRequire(import.meta.url);
 
 const SNAPSHOT_PATH = path.join(__dirname, '..', 'api-snapshot.json');
-const DIST_PATH = path.join(__dirname, '..', 'dist', 'index.js');
+// Prefer dist/cjs/index.js (dual-export layout); fall back to dist/index.js for compat
+const DIST_CJS = path.join(__dirname, '..', 'dist', 'cjs', 'index.js');
+const DIST_LEGACY = path.join(__dirname, '..', 'dist', 'index.js');
+const DIST_PATH = fs.existsSync(DIST_CJS) ? DIST_CJS : DIST_LEGACY;
 
 // Check if dist exists
 if (!fs.existsSync(DIST_PATH)) {
-  console.error('❌ dist/index.js not found. Run `npm run build` first.');
+  console.error('❌ dist/cjs/index.js not found. Run `npm run build` first.');
   process.exit(1);
 }