rdapify 0.2.3 → 0.3.1

package/README.md

@@ -397,109 +397,106 @@ RDAPify is an open source project. Get help or contribute:
 
 ## 🚧 Project Status
 
-**Current Release**: v0.1.8 (Alpha)
-
-### 🎉 What's New in v0.1.7
-
-**Nameserver & Entity Query Support**
-- ✅ **Nameserver Queries**: `client.nameserver('ns1.example.com')` — auto-discovery via IANA DNS bootstrap
-- ✅ **Entity Queries**: `client.entity('ARIN-HN-1', serverUrl)` — contact/registrant/registrar lookup
-- ✅ **CLI Extended**: `rdapify nameserver <hostname>`, `rdapify entity <handle> --server <url>`
-- ✅ **New Types**: `NameserverResponse` and `EntityResponse` exported from main entry point
-- ✅ **New Validators**: `validateNameserver`, `validateEntityHandle`, `normalizeNameserver`, `normalizeEntityHandle`
-- ✅ **All query types** now support full pipeline: caching, middleware hooks, metrics, deduplication, PII redaction
-
-### v0.1.6 — CLI Tool & Runtime Support
-- ✅ **CLI Tool**: `rdapify domain <name>`, `rdapify ip <addr>`, `rdapify asn <num>` — zero external dependencies
-- ✅ **CLI Flags**: `--json`, `--no-cache`, `--timeout <ms>`, `--version/-v`, `--help/-h`
-- ✅ **Cloudflare Workers**: Full runtime detection and support (`isCloudflareWorkers()`)
-- ✅ **Critical Redis Fix**: `RedisCache.clear()` no longer wipes the entire database
-
-**v0.1.5 — Compliance & Middleware**
-- ✅ **Redis Cache**: Production-ready Redis adapter with peer-dependency pattern
-- ✅ **Middleware Hooks**: `beforeQuery`, `afterQuery`, `onError`, `onCacheHit`, `onCacheMiss`, `onRetry` lifecycle hooks
-- ✅ **Query Deduplicator**: Collapses concurrent identical in-flight requests into a single Promise
-- ✅ **Audit Logger**: GDPR/SOC2/CCPA-compliant audit trail with in-memory and file (NDJSON) adapters
-- ✅ **Response Validator**: RFC 7483 schema validation with strict/lenient/off modes
-
-**v0.1.4 — TypeScript Strict Mode**
-- ✅ TypeScript strict mode throughout the entire codebase
-
-**v0.1.3 — 15+ Defensive Bug Fixes**
-- ✅ Normalizer null checks, BootstrapDiscovery NaN guard, Fetcher redirect validation
-- ✅ ConnectionPool acquire timeout, PIIRedactor `structuredClone`, SSRFProtection IPv6 brackets
-- ✅ MetricsCollector division-by-zero protection
-
-**Previous Releases (v0.1.0–v0.1.2)**
-- ✅ Authentication (Basic/Bearer/API Key/OAuth2), Proxy (HTTP/HTTPS/SOCKS4/SOCKS5), Compression (gzip/brotli/deflate)
-- ✅ Retry strategies with circuit breaker, query prioritization, enhanced validation (IDN, IPv6 zones, ASN ranges)
-- ✅ Connection pooling (30-40% faster), metrics & monitoring, request/response logging
-- ✅ Persistent cache (file-based), interactive playground
+**Current Release**: v0.3.0 (Alpha)
+
+### 🎉 What's New in v0.3.0
+
+**Streaming, Monitoring & Runtime Maturity**
+- ✅ **Streaming Batch API**: `client.streamBatch(queries[])` — `AsyncIterable<QueryResult>` with back-pressure (no overflow at 1000+ queries)
+- ✅ **Prometheus Exporter**: `PrometheusExporter` class with `createHttpHandler()` for metrics scraping
+- ✅ **Grafana Dashboard**: Built-in `RDAPIFY_GRAFANA_DASHBOARD` JSON template — import directly into Grafana
+- ✅ **OpenTelemetry Traces**: `TelemetryExporter` + `ClientConfig.telemetry.endpoint` for distributed tracing
+- ✅ **Multi-region Bootstrap**: `ClientConfig.bootstrap.regions: ['us', 'eu', 'ap']` — auto-selects nearest IANA mirror
+- ✅ **Deprecation Engine**: `deprecated()` utility — runtime warning via `process.emitWarning`, emitted once per code path
+- ✅ **BrowserFetcher**: Full browser-compatible fetcher for proxy-based browser environments
+
+### v0.2.3 — Framework Integrations
+
+- ✅ **GraphQL Schema**: framework-agnostic `{ typeDefs, resolvers }` — works with graphql-yoga and any GraphQL server
+- ✅ **Express Middleware**: `rdapifyExpress(client)` — `GET /domain/:name`, `/ip/:address`, `/asn/:number`
+- ✅ **NestJS Module**: `RdapifyModule.forRoot(config)` + `@InjectRdapClient()` decorator
+
+### v0.2.2 — Edge Runtime Support
+
+- ✅ **Deno Support**: `DenoFetcher` with `isDeno()` runtime detection
+- ✅ **Cloudflare Workers**: `CloudflareWorkersFetcher` — no `fs` or `process` dependencies; edge-compatible
+- ✅ **Package exports**: `./worker`, `./deno`, `./node` entry points
+
+### v0.2.1 — Bun Runtime
+
+- ✅ **BunFetcher**: `BunFetcher implements IFetcherPort` — uses `Bun.fetch`; auto-selected when Bun is detected
+- ✅ **CI**: Bun job added to `.github/workflows/ci.yml`
+
+### v0.2.0 — Core Enhancements
+
+- ✅ **Circuit Breaker**: complete `closed → open → half-open → closed/open` state machine
+- ✅ **Redis Pipeline**: batch `getMany`/`setMany` + SHA-256 key compression for long keys
+- ✅ **Middleware `ctx.abort()`**: `beforeQuery` hooks can now abort queries (`QueryAbortedError`)
+- ✅ **Middleware Priority**: numeric priority ordering (lower = higher priority)
+- ✅ **HTTP/2 Support**: opt-in via `ClientConfig.http2: boolean`
+
+### v0.1.9 — Availability & Bootstrap
+
+- ✅ **Domain Availability**: `client.checkAvailability(domain)` — RDAP-only, returns `{ available, expiresAt? }`
+- ✅ **Bulk Availability**: `client.checkAvailabilityBatch(domains[])` — concurrent batch
+- ✅ **Live Integration Tests**: opt-in `npm run test:live` via `LIVE_TESTS=1` (weekly CI workflow, does not block merge)
+- ✅ **Advanced Bootstrap Config**: `customServers`, `ttl` override, `fallback` to IANA
+
+**Previous Releases (v0.1.0–v0.1.8)**
+- ✅ Rust native backend (`rdapify-nd`), CLI tool, nameserver/entity queries, TypeScript strict mode
+- ✅ Redis cache, middleware hooks, query deduplication, audit logger, RFC 7483 response validation
+- ✅ Authentication (Basic/Bearer/API Key/OAuth2), proxy (HTTP/HTTPS/SOCKS4/SOCKS5), compression
+- ✅ Retry strategies, circuit breaker, query prioritization, connection pooling, metrics & monitoring
 
 See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 
-### ✅ Full Feature Set (v0.1.8)
+### ✅ Full Feature Set (v0.3.0)
 
 - ✅ **RDAP Client**: Domain, IP, ASN, Nameserver, and Entity queries with automatic IANA bootstrap discovery
-- ✅ **CLI Tool**: Command-line interface with human-readable and JSON output (`domain`, `ip`, `asn`, `nameserver`, `entity`)
+- ✅ **Domain Availability**: `client.checkAvailability()` + `client.checkAvailabilityBatch()` via RDAP
+- ✅ **CLI Tool**: `rdapify domain/ip/asn/nameserver/entity` with `--json`, `--no-cache`, `--timeout`, `--server` flags
 - ✅ **SSRF Protection**: Blocks private IPs, localhost, link-local, CIDR matching (IPv4/IPv6)
 - ✅ **Data Normalization**: Consistent response format across all registries
 - ✅ **PII Redaction**: Automatic redaction of emails, phones, addresses (GDPR/CCPA)
 - ✅ **Audit Logging**: Compliance-grade audit trail (GDPR/SOC2/CCPA) with NDJSON file adapter
 - ✅ **In-Memory Cache**: LRU cache with TTL support
 - ✅ **Persistent Cache**: File-based cache that survives restarts
-- ✅ **Redis Cache**: Production-ready Redis adapter
+- ✅ **Redis Cache**: Production-ready Redis adapter with pipeline + key compression
 - ✅ **Connection Pooling**: HTTP connection reuse (30-40% faster)
 - ✅ **Metrics & Monitoring**: Comprehensive query tracking and analysis
+- ✅ **Prometheus Exporter**: `PrometheusExporter` + `createHttpHandler()` for metrics scraping
+- ✅ **Grafana Dashboard**: Built-in JSON dashboard template
+- ✅ **OpenTelemetry Traces**: Distributed tracing via `TelemetryExporter`
 - ✅ **Request/Response Logging**: Structured logging with configurable levels
 - ✅ **Retry Strategies**: Circuit breaker (closed/open/half-open) with exponential backoff
 - ✅ **Query Prioritization**: High/normal/low priority queue
 - ✅ **Query Deduplication**: Collapse concurrent identical requests into one
-- ✅ **Middleware Hooks**: Lifecycle hooks for query pipeline customization
+- ✅ **Middleware Hooks**: Lifecycle hooks with `ctx.abort()` support and priority ordering
 - ✅ **Response Validation**: RFC 7483 schema validation
 - ✅ **Enhanced Validation**: IDN domains, IPv6 zones, ASN ranges
 - ✅ **Authentication**: Basic, Bearer, API Key, OAuth2
 - ✅ **Proxy Support**: HTTP/HTTPS/SOCKS4/SOCKS5 with bypass patterns
 - ✅ **Response Compression**: gzip, brotli, deflate (60-80% bandwidth reduction)
-- ✅ **Rust Native Backend**: optional `rdapify-nd` for lower-latency queries via compiled Rust (`backend: 'auto' | 'native' | 'typescript'`)
-- ✅ **Multi-runtime**: Node.js 20+, Bun, Deno, Cloudflare Workers
+- ✅ **HTTP/2 Support**: opt-in via `ClientConfig.http2: boolean`
+- ✅ **Streaming API**: `client.streamBatch()` — `AsyncIterable<QueryResult>` with back-pressure
+- ✅ **Multi-region Bootstrap**: `ClientConfig.bootstrap.regions` — nearest IANA mirror selection
+- ✅ **GraphQL Schema**: framework-agnostic `{ typeDefs, resolvers }` for graphql-yoga and others
+- ✅ **Express Middleware**: `rdapifyExpress(client)` — drop-in REST routes
+- ✅ **NestJS Module**: `RdapifyModule.forRoot(config)` + `@InjectRdapClient()` decorator
+- ✅ **Rust Native Backend**: optional `rdapify-nd` (`backend: 'auto' | 'native' | 'typescript'`)
+- ✅ **Multi-runtime**: Node.js 20+, Bun (`BunFetcher`), Deno (`DenoFetcher`), Cloudflare Workers (`CloudflareWorkersFetcher`), Browser (`BrowserFetcher`)
+- ✅ **Deprecation Engine**: runtime warnings via `process.emitWarning`, once per code path
 - ✅ **TypeScript Strict**: Full type definitions with strict mode
-- ✅ **Test Coverage**: 34 test files, 620+ tests (unit + integration)
-
-### 🎉 What's New in v0.1.8
+- ✅ **Test Coverage**: 1066+ tests (unit + integration + security), 90.4% branch coverage
 
-**Rust Native Backend (`rdapify-nd`)**
-- ✅ **Optional native backend**: install `rdapify-nd` alongside `rdapify` for lower-latency queries powered by compiled Rust
-- ✅ **`backend` option**: `'auto'` (default, uses native if available), `'native'` (require native), `'typescript'` (always use TS pipeline)
-- ✅ **`isNativeAvailable()`**: runtime detection utility to check if native binary is loaded
-- ✅ **Transparent fallback**: when `rdapify-nd` is absent, all existing behaviour is preserved with zero configuration change
+### 🔜 Coming in v1.0.0-rc.1
 
-```ts
-import { RDAPClient, isNativeAvailable } from 'rdapify';
-
-console.log(isNativeAvailable()); // true if rdapify-nd is installed
-
-const client = new RDAPClient({ backend: 'auto' });   // transparent
-const client2 = new RDAPClient({ backend: 'native' }); // throws if not installed
-const client3 = new RDAPClient({ backend: 'typescript' }); // always TS pipeline
-```
+- ⏳ **API Freeze**: all public exports locked — no breaking changes after this point
+- ⏳ **External Security Audit**: independent audit firm review of rdapify + rdapify-rust
+- ⏳ **Runtime Certification**: Bun, Deno, and Cloudflare Workers verified in live environments
+- ⏳ **RC Feedback Period**: 4-week community feedback window before stable release
 
-### 🔜 Coming in v0.1.9
-
-- ⏳ **Domain Availability**: `client.checkAvailability('example.com')` — instant availability check via RDAP
-- ⏳ **Bulk Availability**: `client.checkAvailabilityBatch(['a.com', 'b.com'])` — check multiple domains at once
-- ⏳ **Live Integration Tests**: opt-in via `LIVE_TESTS=1` against real RDAP servers
-- ⏳ **Advanced Bootstrap Config**: custom bootstrap servers, TTL overrides, redundancy fallback
-
-### 📋 Roadmap to v0.2.0
-
-- RDAP Testing CLI (`rdapify test server`, `rdapify test benchmark`)
-- RDAP Extensions Registry (REGEXT support)
-- Bootstrap Store Adapters (File, Redis, Database)
-- Advanced Reporting (`client.generateReport()`)
-- RFC 9083 / RFC 9535 support
-
-See [ROADMAP.md](ROADMAP.md) for the complete roadmap and [CHANGELOG.md](CHANGELOG.md) for detailed version history.
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 
 ## 🏗️ Code Architecture
 

package/dist/{application → cjs/application}/client/RDAPClient.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RDAPClient = void 0;
 const cache_1 = require("../../infrastructure/cache");
@@ -13,6 +46,8 @@ const security_1 = require("../../infrastructure/security");
 const MetricsCollector_1 = require("../../infrastructure/monitoring/MetricsCollector");
 const Logger_1 = require("../../infrastructure/logging/Logger");
 const errors_1 = require("../../shared/errors");
+const UsageTelemetry_1 = require("../../infrastructure/telemetry/UsageTelemetry");
+const validators_1 = require("../../shared/utils/validators");
 const options_1 = require("../../shared/types/options");
 const helpers_1 = require("../../shared/utils/helpers");
 const services_1 = require("../services");
@@ -69,6 +104,7 @@ class RDAPClient {
                 maxRedirects: this.options.maxRedirects,
                 ssrfProtection: this.ssrfProtection,
                 http2: this.options.http2,
+                signal: this.options.signal,
                 logRedirect: (fromUrl, toUrl) => {
                     this.logger?.warn(`Redirect: ${fromUrl} → ${toUrl}`);
                     if (this.debugEnabled && this.debugLogger) {
@@ -155,27 +191,37 @@ class RDAPClient {
     async domain(domain) {
         if (this.nativeBackend)
             return this.nativeBackend.domain(domain);
-        return this.orchestrator.queryDomain(domain);
+        const result = await this.orchestrator.queryDomain(domain);
+        this.pingTelemetry('domain');
+        return result;
     }
     async ip(ip) {
         if (this.nativeBackend)
             return this.nativeBackend.ip(ip);
-        return this.orchestrator.queryIP(ip);
+        const result = await this.orchestrator.queryIP(ip);
+        this.pingTelemetry('ip');
+        return result;
     }
     async asn(asn) {
         if (this.nativeBackend)
             return this.nativeBackend.asn(asn);
-        return this.orchestrator.queryASN(asn);
+        const result = await this.orchestrator.queryASN(asn);
+        this.pingTelemetry('asn');
+        return result;
     }
     async nameserver(nameserver) {
         if (this.nativeBackend)
             return this.nativeBackend.nameserver(nameserver);
-        return this.orchestrator.queryNameserver(nameserver);
+        const result = await this.orchestrator.queryNameserver(nameserver);
+        this.pingTelemetry('nameserver');
+        return result;
     }
     async entity(handle, serverUrl) {
         if (this.nativeBackend)
             return this.nativeBackend.entity(handle, serverUrl);
-        return this.orchestrator.queryEntity(handle, serverUrl);
+        const result = await this.orchestrator.queryEntity(handle, serverUrl);
+        this.pingTelemetry('entity');
+        return result;
     }
     async checkAvailability(domain) {
         try {
@@ -198,6 +244,125 @@ class RDAPClient {
         }));
         return new Map(entries);
     }
+    async searchDomains(pattern, serverUrl) {
+        const server = serverUrl ?? (await this.bootstrap.discoverDomain('example.com'));
+        const url = `${server}/domains?name=${encodeURIComponent(pattern)}`;
+        let raw;
+        try {
+            raw = await this.fetchWithRetry(url);
+        }
+        catch (error) {
+            if (error instanceof errors_1.RDAPServerError &&
+                (error.statusCode === 404 || error.statusCode === 501)) {
+                throw new errors_1.SearchNotSupportedError(`RDAP server does not support domain search: ${server}`, { pattern, serverUrl: server });
+            }
+            throw error;
+        }
+        const domainSearchResults = raw['domainSearchResults'] ?? [];
+        const results = domainSearchResults.map((item) => this.normalizer.normalize(item, pattern, server, false, this.options.includeRaw));
+        return { results, totalCount: results.length, query: pattern };
+    }
+    async searchEntities(pattern, serverUrl) {
+        if (!serverUrl) {
+            throw new errors_1.SearchNotSupportedError('searchEntities requires an explicit serverUrl — there is no global bootstrap for entities', { pattern });
+        }
+        const url = `${serverUrl}/entities?fn=${encodeURIComponent(pattern)}`;
+        let raw;
+        try {
+            raw = await this.fetchWithRetry(url);
+        }
+        catch (error) {
+            if (error instanceof errors_1.RDAPServerError &&
+                (error.statusCode === 404 || error.statusCode === 501)) {
+                throw new errors_1.SearchNotSupportedError(`RDAP server does not support entity search: ${serverUrl}`, { pattern, serverUrl });
+            }
+            throw error;
+        }
+        const entitySearchResults = raw['entitySearchResults'] ?? [];
+        const results = entitySearchResults.map((item) => this.normalizer.normalize(item, pattern, serverUrl, false, this.options.includeRaw));
+        return { results, totalCount: results.length, query: pattern };
+    }
+    async explain(query) {
+        const startTime = Date.now();
+        let queryType = 'domain';
+        let detectedType = 'unknown';
+        try {
+            if (/^\d+$/.test(query) || /^AS\d+$/i.test(query)) {
+                (0, validators_1.validateASN)(query);
+                queryType = 'asn';
+                detectedType = 'asn';
+            }
+            else if (query.includes('.') && /^\d/.test(query)) {
+                (0, validators_1.validateIP)(query);
+                queryType = 'ip';
+                detectedType = 'ipv4';
+            }
+            else if (query.includes(':')) {
+                (0, validators_1.validateIP)(query);
+                queryType = 'ip';
+                detectedType = 'ipv6';
+            }
+            else {
+                (0, validators_1.validateDomain)(query);
+                queryType = 'domain';
+                detectedType = 'domain';
+            }
+        }
+        catch {
+            queryType = 'domain';
+            detectedType = 'unknown';
+        }
+        const cacheEnabled = this.options.cache !== false;
+        let cacheStatus = cacheEnabled ? 'miss' : 'disabled';
+        if (cacheEnabled) {
+            const { generateCacheKey } = await Promise.resolve().then(() => __importStar(require('../../shared/utils/helpers')));
+            const cacheKey = generateCacheKey(queryType, query.toLowerCase());
+            const cached = await this.cache.get(cacheKey);
+            if (cached)
+                cacheStatus = 'hit';
+        }
+        let bootstrapServer = null;
+        let builtUrl = null;
+        let error;
+        try {
+            if (queryType === 'domain') {
+                bootstrapServer = await this.bootstrap.discoverDomain(query.toLowerCase());
+                builtUrl = `${bootstrapServer}/domain/${query.toLowerCase()}`;
+            }
+            else if (queryType === 'ip') {
+                const version = (0, validators_1.validateIP)(query);
+                bootstrapServer =
+                    version === 'v4'
+                        ? await this.bootstrap.discoverIPv4(query)
+                        : await this.bootstrap.discoverIPv6(query);
+                builtUrl = `${bootstrapServer}/ip/${query}`;
+            }
+            else if (queryType === 'asn') {
+                const asnNum = (0, validators_1.validateASN)(query);
+                bootstrapServer = await this.bootstrap.discoverASN(asnNum);
+                builtUrl = `${bootstrapServer}/autnum/${asnNum}`;
+            }
+        }
+        catch (err) {
+            error = err instanceof Error ? err.message : String(err);
+        }
+        return {
+            query,
+            queryType,
+            detectedType,
+            bootstrapServer,
+            builtUrl,
+            cacheStatus,
+            latencyMs: Date.now() - startTime,
+            error,
+        };
+    }
+    pingTelemetry(queryType) {
+        const telemetryOpts = this.options.usageTelemetry;
+        if (telemetryOpts?.enabled === true) {
+            UsageTelemetry_1.UsageTelemetry.ping(queryType, telemetryOpts.endpoint);
+        }
+    }
     async fetchWithRetry(url) {
         const retryOptions = typeof this.options.retry === 'boolean'
             ? this.options.retry
@@ -226,6 +391,33 @@ class RDAPClient {
     normalizeOptions(options) {
         return (0, helpers_1.deepMerge)(options_1.DEFAULT_OPTIONS, options);
     }
+    async validate() {
+        const errors = [];
+        const warnings = [];
+        const bootstrapUrl = this.options.bootstrapUrl;
+        if (bootstrapUrl && bootstrapUrl !== 'https://data.iana.org/rdap') {
+            try {
+                await this.fetcher.fetch(`${bootstrapUrl}/dns.json`);
+            }
+            catch {
+                errors.push(`Bootstrap URL unreachable: ${bootstrapUrl}`);
+            }
+        }
+        const cacheOpts = this.options.cache;
+        if (cacheOpts?.strategy === 'redis' && cacheOpts?.redisClient) {
+            try {
+                await cacheOpts.redisClient.ping();
+            }
+            catch {
+                errors.push('Redis connection failed');
+            }
+        }
+        const ssrfOpts = this.options.ssrfProtection;
+        if (ssrfOpts?.enabled === false) {
+            warnings.push('SSRF protection disabled — not safe for production');
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
     async clearCache() {
         await this.cache.clear();
         this.bootstrap.clearCache();
@@ -282,4 +474,3 @@ class RDAPClient {
     }
 }
 exports.RDAPClient = RDAPClient;
-//# sourceMappingURL=RDAPClient.js.map

package/dist/{application → cjs/application}/client/index.js

@@ -3,4 +3,3 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RDAPClient = void 0;
 var RDAPClient_1 = require("./RDAPClient");
 Object.defineProperty(exports, "RDAPClient", { enumerable: true, get: function () { return RDAPClient_1.RDAPClient; } });
-//# sourceMappingURL=index.js.map

package/dist/{application → cjs/application}/deduplication/QueryDeduplicator.js

@@ -43,4 +43,3 @@ class QueryDeduplicator {
     }
 }
 exports.QueryDeduplicator = QueryDeduplicator;
-//# sourceMappingURL=QueryDeduplicator.js.map

package/dist/{application → cjs/application}/hooks/MiddlewareHooks.js

@@ -81,4 +81,3 @@ class MiddlewareManager {
     }
 }
 exports.MiddlewareManager = MiddlewareManager;
-//# sourceMappingURL=MiddlewareHooks.js.map

package/dist/{application → cjs/application}/services/BatchProcessor.js

@@ -147,4 +147,3 @@ class BatchProcessor {
     }
 }
 exports.BatchProcessor = BatchProcessor;
-//# sourceMappingURL=BatchProcessor.js.map

package/dist/{application → cjs/application}/services/QueryOrchestrator.js

@@ -617,4 +617,3 @@ class QueryOrchestrator {
     }
 }
 exports.QueryOrchestrator = QueryOrchestrator;
-//# sourceMappingURL=QueryOrchestrator.js.map

package/dist/{application → cjs/application}/services/QueryPriority.js

@@ -111,4 +111,3 @@ class QueryPriorityQueue {
     }
 }
 exports.QueryPriorityQueue = QueryPriorityQueue;
-//# sourceMappingURL=QueryPriority.js.map

package/dist/{application → cjs/application}/services/index.js

@@ -5,4 +5,3 @@ var QueryOrchestrator_1 = require("./QueryOrchestrator");
 Object.defineProperty(exports, "QueryOrchestrator", { enumerable: true, get: function () { return QueryOrchestrator_1.QueryOrchestrator; } });
 var BatchProcessor_1 = require("./BatchProcessor");
 Object.defineProperty(exports, "BatchProcessor", { enumerable: true, get: function () { return BatchProcessor_1.BatchProcessor; } });
-//# sourceMappingURL=index.js.map

package/dist/{cli → cjs/cli}/index.js

@@ -297,4 +297,3 @@ main().catch((err) => {
     process.stderr.write(`Fatal: ${message}\n`);
     process.exit(1);
 });
-//# sourceMappingURL=index.js.map

package/dist/cjs/core/ports/bootstrap.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/core/ports/cache.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/core/ports/fetcher.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/{core → cjs/core}/ports/index.js

@@ -6,4 +6,3 @@ tslib_1.__exportStar(require("./fetcher.port"), exports);
 tslib_1.__exportStar(require("./normalizer.port"), exports);
 tslib_1.__exportStar(require("./bootstrap.port"), exports);
 tslib_1.__exportStar(require("./pii-redactor.port"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/core/ports/normalizer.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/core/ports/pii-redactor.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/{index.js → cjs/index.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompressionManager = exports.ProxyManager = exports.AuthenticationManager = exports.asciiToIdn = exports.idnToAscii = exports.isPunycodeDomain = exports.isIdnDomain = exports.validateAsnRange = exports.validateIpv6WithZone = exports.validateIdnDomain = exports.PersistentCache = exports.QueryPriorityQueue = exports.RetryStrategy = exports.Logger = exports.MetricsCollector = exports.ConnectionPool = exports.RateLimiter = exports.BatchProcessor = exports.VERSION = exports.normalizeEntityHandle = exports.normalizeNameserver = exports.normalizeASN = exports.normalizeIP = exports.normalizeDomain = exports.isLinkLocal = exports.isLocalhost = exports.isPrivateIP = exports.validateEntityHandle = exports.validateNameserver = exports.validateASN = exports.validateIPv6 = exports.validateIPv4 = exports.validateIP = exports.validateDomain = exports.isRateLimitError = exports.isTimeoutError = exports.isNetworkError = exports.isSSRFProtectionError = exports.isRDAPifyError = exports.RateLimitError = exports.CacheError = exports.ParseError = exports.ValidationError = exports.NoServerFoundError = exports.RDAPServerError = exports.TimeoutError = exports.NetworkError = exports.SSRFProtectionError = exports.RDAPifyError = exports.RDAPClient = void 0;
-exports.deprecated = exports.RDAPIFY_GRAFANA_DASHBOARD = exports.TelemetryExporter = exports.PrometheusExporter = exports.RDAPIFY_CLIENT_TOKEN = exports.InjectRdapClient = exports.RdapifyModule = exports.MinimalRouter = exports.rdapifyExpress = exports.RDAPIFY_TYPE_DEFS = exports.createRdapifySchema = exports.BrowserFetcher = exports.CloudflareWorkersFetcher = exports.DenoFetcher = exports.BunFetcher = exports.QueryAbortedError = exports.CircuitOpenError = exports.CircuitBreaker = exports.isNativeAvailable = exports.getRuntimeName = exports.isCloudflareWorkers = exports.isBun = exports.isDeno = exports.isBrowser = exports.isNode = exports.ResponseValidator = exports.FileAuditAdapter = exports.InMemoryAuditAdapter = exports.AuditLogger = exports.QueryDeduplicator = exports.MiddlewareManager = exports.RedisCache = void 0;
+exports.asciiToIdn = exports.idnToAscii = exports.isPunycodeDomain = exports.isIdnDomain = exports.validateAsnRange = exports.validateIpv6WithZone = exports.validateIdnDomain = exports.PersistentCache = exports.QueryPriorityQueue = exports.RetryStrategy = exports.Logger = exports.MetricsCollector = exports.ConnectionPool = exports.DistributedRateLimiter = exports.RateLimiter = exports.BatchProcessor = exports.VERSION = exports.UsageTelemetry = exports.normalizeEntityHandle = exports.normalizeNameserver = exports.normalizeASN = exports.normalizeIP = exports.normalizeDomain = exports.isLinkLocal = exports.isLocalhost = exports.isPrivateIP = exports.validateEntityHandle = exports.validateNameserver = exports.validateASN = exports.validateIPv6 = exports.validateIPv4 = exports.validateIP = exports.validateDomain = exports.isRateLimitError = exports.isTimeoutError = exports.isNetworkError = exports.isSSRFProtectionError = exports.isRDAPifyError = exports.SearchNotSupportedError = exports.RateLimitError = exports.CacheError = exports.ParseError = exports.ValidationError = exports.NoServerFoundError = exports.RDAPServerError = exports.TimeoutError = exports.NetworkError = exports.SSRFProtectionError = exports.RDAPifyError = exports.RDAPClient = void 0;
+exports.deprecated = exports.RDAPIFY_GRAFANA_DASHBOARD = exports.TelemetryExporter = exports.PrometheusExporter = exports.RDAPIFY_CLIENT_TOKEN = exports.InjectRdapClient = exports.RdapifyModule = exports.MinimalRouter = exports.rdapifyExpress = exports.RDAPIFY_TYPE_DEFS = exports.createRdapifySchema = exports.BrowserFetcher = exports.CloudflareWorkersFetcher = exports.DenoFetcher = exports.BunFetcher = exports.QueryAbortedError = exports.CircuitOpenError = exports.CircuitBreaker = exports.isNativeAvailable = exports.getRuntimeName = exports.isCloudflareWorkers = exports.isBun = exports.isDeno = exports.isBrowser = exports.isNode = exports.ResponseValidator = exports.FileAuditAdapter = exports.InMemoryAuditAdapter = exports.AuditLogger = exports.QueryDeduplicator = exports.MiddlewareManager = exports.RedisCache = exports.CompressionManager = exports.ProxyManager = exports.AuthenticationManager = void 0;
 var client_1 = require("./application/client");
 Object.defineProperty(exports, "RDAPClient", { enumerable: true, get: function () { return client_1.RDAPClient; } });
 var errors_1 = require("./shared/errors");
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "ValidationError", { enumerable: true, get: funct
 Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return errors_1.ParseError; } });
 Object.defineProperty(exports, "CacheError", { enumerable: true, get: function () { return errors_1.CacheError; } });
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "SearchNotSupportedError", { enumerable: true, get: function () { return errors_1.SearchNotSupportedError; } });
 Object.defineProperty(exports, "isRDAPifyError", { enumerable: true, get: function () { return errors_1.isRDAPifyError; } });
 Object.defineProperty(exports, "isSSRFProtectionError", { enumerable: true, get: function () { return errors_1.isSSRFProtectionError; } });
 Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return errors_1.isNetworkError; } });
@@ -36,11 +37,15 @@ Object.defineProperty(exports, "normalizeIP", { enumerable: true, get: function
 Object.defineProperty(exports, "normalizeASN", { enumerable: true, get: function () { return validators_1.normalizeASN; } });
 Object.defineProperty(exports, "normalizeNameserver", { enumerable: true, get: function () { return validators_1.normalizeNameserver; } });
 Object.defineProperty(exports, "normalizeEntityHandle", { enumerable: true, get: function () { return validators_1.normalizeEntityHandle; } });
-exports.VERSION = '0.3.0';
+var UsageTelemetry_1 = require("./infrastructure/telemetry/UsageTelemetry");
+Object.defineProperty(exports, "UsageTelemetry", { enumerable: true, get: function () { return UsageTelemetry_1.UsageTelemetry; } });
+exports.VERSION = '0.3.1';
 var BatchProcessor_1 = require("./application/services/BatchProcessor");
 Object.defineProperty(exports, "BatchProcessor", { enumerable: true, get: function () { return BatchProcessor_1.BatchProcessor; } });
 var RateLimiter_1 = require("./infrastructure/http/RateLimiter");
 Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return RateLimiter_1.RateLimiter; } });
+var DistributedRateLimiter_1 = require("./infrastructure/http/DistributedRateLimiter");
+Object.defineProperty(exports, "DistributedRateLimiter", { enumerable: true, get: function () { return DistributedRateLimiter_1.DistributedRateLimiter; } });
 var ConnectionPool_1 = require("./infrastructure/http/ConnectionPool");
 Object.defineProperty(exports, "ConnectionPool", { enumerable: true, get: function () { return ConnectionPool_1.ConnectionPool; } });
 var MetricsCollector_1 = require("./infrastructure/monitoring/MetricsCollector");
@@ -121,4 +126,3 @@ var deprecation_1 = require("./shared/utils/deprecation");
 Object.defineProperty(exports, "deprecated", { enumerable: true, get: function () { return deprecation_1.deprecated; } });
 const client_2 = require("./application/client");
 exports.default = client_2.RDAPClient;
-//# sourceMappingURL=index.js.map

package/dist/{infrastructure → cjs/infrastructure}/cache/CacheManager.js

@@ -4,6 +4,7 @@ exports.CacheManager = void 0;
 const errors_1 = require("../../shared/errors");
 const InMemoryCache_1 = require("./InMemoryCache");
 const RedisCache_1 = require("./RedisCache");
+const StaleWhileRevalidateCache_1 = require("./StaleWhileRevalidateCache");
 class CacheManager {
     constructor(options = {}) {
         this.ttl = options.ttl || 3600;
@@ -30,6 +31,9 @@ class CacheManager {
             case 'none':
                 this.cache = new NoOpCache();
                 break;
+            case 'stale-while-revalidate':
+                this.cache = new StaleWhileRevalidateCache_1.StaleWhileRevalidateCache(options.maxSize || 1000, options.revalidateCallback);
+                break;
         }
     }
     async get(key) {
@@ -121,4 +125,3 @@ class NoOpCache {
         return 0;
     }
 }
-//# sourceMappingURL=CacheManager.js.map

package/dist/{infrastructure → cjs/infrastructure}/cache/InMemoryCache.js

@@ -93,4 +93,3 @@ class InMemoryCache {
     }
 }
 exports.InMemoryCache = InMemoryCache;
-//# sourceMappingURL=InMemoryCache.js.map

package/dist/{infrastructure → cjs/infrastructure}/cache/PersistentCache.js

@@ -191,4 +191,3 @@ class PersistentCache {
     }
 }
 exports.PersistentCache = PersistentCache;
-//# sourceMappingURL=PersistentCache.js.map

package/dist/{infrastructure → cjs/infrastructure}/cache/RedisCache.js

@@ -108,4 +108,3 @@ class RedisCache {
     }
 }
 exports.RedisCache = RedisCache;
-//# sourceMappingURL=RedisCache.js.map