rdapify 0.1.0-alpha.4 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,92 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.1.0] - 2025-01-25
+
+### Added
+- Initial public release of RDAPify
+- Core RDAP client with domain, IP, and ASN query support
+- Automatic RDAP server discovery via IANA Bootstrap
+- SSRF protection with proper CIDR matching for IPv4 and IPv6
+- PII redaction for GDPR/CCPA compliance
+- In-memory caching with configurable TTL
+- Data normalization for consistent response format
+- Comprehensive TypeScript types and interfaces
+- Input validation for domains, IPs, and ASNs
+- Retry logic with configurable backoff strategies
+- Interactive playground for testing RDAP queries
+- Playground API proxy server with Express
+- Comprehensive community health files (SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SUPPORT.md)
+- Issue templates (bug report, feature request, question)
+- Pull request template with comprehensive checklist
+- Funding configuration for GitHub Sponsors and Open Collective
+- Organization profile with professional presentation
+
+### Infrastructure
+- CI/CD workflows for Node.js 16, 18, and 20
+- CodeQL security analysis (weekly scans)
+- Dependabot for automated dependency updates
+- Dependency review for pull requests
+- Automated testing and linting
+- GitHub Actions for release automation
+
+### Security
+- SSRF protection blocks private IPs, localhost, and internal domains
+- Certificate validation enforced (HTTPS only)
+- Proper CIDR matching using ipaddr.js library
+- Input validation prevents injection attacks
+- Automated security scanning with CodeQL
+- Secret scanning configuration
+- Dependabot security updates
+
+### Documentation
+- Comprehensive README with examples
+- API documentation
+- Security policy
+- Contributing guidelines
+- Code of conduct
+- Support resources
+
+### Testing
+- 146+ unit and integration tests
+- Mocked fixtures for reliable testing
+- Coverage reporting
+
+## [0.1.0-alpha.4] - 2025-01-25
+
+### Added
+- Dependabot configuration for automated dependency updates
+- Enhanced CI/CD workflows with multi-version Node.js testing (Node.js 16, 18, 20)
+- CodeQL security analysis workflow (weekly scans)
+- Dependency review workflow for pull requests
+- Interactive playground for testing RDAP queries
+- Playground API proxy server with Express
+- Comprehensive community health files (SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SUPPORT.md)
+- Issue templates (bug report, feature request, question)
+- Pull request template with comprehensive checklist
+- Funding configuration for GitHub Sponsors and Open Collective
+- Organization profile with professional presentation
+
+### Changed
+- Improved CI workflow to test on multiple Node.js versions
+- Simplified CodeQL configuration
+- Updated organization profile with professional presentation
+- Enhanced documentation structure
+- Improved .gitignore to exclude .kiro directory
+
+### Security
+- Added automated security scanning with CodeQL
+- Enabled dependency review for pull requests
+- Configured Dependabot for security updates
+- Set up weekly security scans
+
+### Infrastructure
+- Added CI/CD workflows for automated testing
+- Configured Dependabot for dependency management
+- Set up CodeQL for security analysis
+
 ## [0.1.0-alpha.2] - 2026-01-22
 
 ### Fixed

package/README.md

@@ -1,10 +1,12 @@
 # RDAPify - Unified, Secure, High-Performance RDAP Client for Enterprise Applications
 
-> **⚠️ ALPHA RELEASE**: This is v0.1.0-alpha.1 — core functionality is working and tested, but some advanced features are still in development. See [What's Ready](#-whats-ready-in-v010-alpha1) below.
+> **🎉 STABLE RELEASE**: This is v0.1.0 — the first stable public release with production-ready core functionality. See [What's Ready](#-whats-ready-in-v010) below.
 
 [![npm version](https://img.shields.io/npm/v/rdapify?style=flat-square)](https://www.npmjs.com/package/rdapify)
 [![License](https://img.shields.io/npm/l/rdapify?style=flat-square)](LICENSE)
 [![Security](https://img.shields.io/badge/security-SSRF%20Protected-brightgreen?style=flat-square)](SECURITY.md)
+[![Website](https://img.shields.io/badge/website-rdapify.com-blue?style=flat-square)](https://rdapify.com)
+[![GitHub](https://img.shields.io/github/stars/rdapify/RDAPify?style=flat-square)](https://github.com/rdapify/RDAPify)
 
 **RDAPify** unifies RDAP queries across all global registries (Verisign, ARIN, RIPE, APNIC, LACNIC) with robust security protection, exceptional performance, and an integrated developer experience. This isn't just another RDAP client — it's a complete platform for processing registration data securely.
 
@@ -27,7 +29,7 @@ RDAPify intelligently addresses these challenges:
 - ✅ **Data Normalization**: Consistent response regardless of source registry
 - ✅ **SSRF Protection**: Prevent attacks on internal infrastructure
 - ✅ **Exceptional Performance**: Smart caching, parallel processing, memory optimization
-- ✅ **Broad Compatibility**: Works on Node.js, Bun, Deno, Cloudflare Workers
+- ✅ **Node.js Compatibility**: Verified working on Node.js (target: 16+; Bun, Deno, Cloudflare Workers: untested)
 - ✅ **GDPR-ready**: Built-in tools for automatically redacting personal data
 
 ## 📦 Quick Installation
@@ -41,26 +43,23 @@ yarn add rdapify
 
 # Using pnpm
 pnpm add rdapify
+```
 
-# Using Bun
+**Experimental (untested):**
+```bash
+# Using Bun (untested)
 bun add rdapify
 ```
 
 ## ⚡ Get Started in 30 Seconds
 
+### Basic Usage
+
 ```typescript
 import { RDAPClient } from 'rdapify';
 
-// Create a secure client with optimized defaults
-const client = new RDAPClient({
-  cache: true, // Automatic caching (1 hour TTL)
-  redactPII: true, // Automatically redact personal information
-  retry: {
-    // Smart retries for transient failures
-    maxAttempts: 3,
-    backoff: 'exponential',
-  },
-});
+// Create a client with default settings
+const client = new RDAPClient();
 
 // Query a domain
 const result = await client.domain('example.com');
@@ -75,7 +74,29 @@ console.log({
 });
 ```
 
-**Output:**
+### With Security & Performance Options
+
+```typescript
+import { RDAPClient } from 'rdapify';
+
+// Create a secure client with optimized defaults
+const client = new RDAPClient({
+  cache: true, // Automatic caching (1 hour TTL)
+  redactPII: true, // Automatically redact personal information
+  retry: {
+    // Smart retries for transient failures
+    maxAttempts: 3,
+    backoff: 'exponential',
+  },
+});
+
+// Query domain, IP, or ASN
+const domain = await client.domain('example.com');
+const ip = await client.ip('8.8.8.8');
+const asn = await client.asn('AS15169');
+```
+
+**Example Output:**
 
 ```json
 {
@@ -100,21 +121,23 @@ console.log({
 
 ### ⚡ Exceptional Performance
 
-- **Advanced Caching**: Supports In-memory, Redis, and geo-distributed caching
-- **Parallel Processing**: Handle 1000+ domains in seconds
+- **Smart Caching**: In-memory LRU cache with configurable TTL (Redis support planned)
+- **Batch Processing**: Process multiple queries efficiently
 - **Registry Discovery**: Automatic IANA Bootstrap for finding the correct registry
-- **Offline Mode**: Work with cached data during network outages
-- **Priority Queues**: Ensure critical requests are processed first
+- **Offline Mode**: Work with cached data during network outages (planned)
+- **Optimized Parsing**: Fast JSONPath-based normalization
 
 ### 🧩 Seamless Integration
 
 - **Full TypeScript Support**: Strongly typed with embedded documentation
-- **Multi-environment Support**: Works on Node.js (16+), Bun, Deno, Cloudflare Workers
-- **Interactive CLI**: For quick queries and testing
-- **Web Playground**: Try the library directly in your browser
-- **Pre-built Templates**: For AWS Lambda, Azure Functions, Kubernetes, and more
+- **Node.js Support**: Verified working (target: Node.js 16+; other runtimes untested)
+- **Interactive CLI**: For quick queries and testing (planned)
+- **Web Playground**: Try the library directly in your browser (planned)
+- **Pre-built Templates**: For AWS Lambda, Azure Functions, Kubernetes, and more (planned)
+
+### 📊 Advanced Analytics (Planned)
 
-### 📊 Advanced Analytics
+Future releases will include:
 
 - **Customizable Dashboards**: Track critical domains and assets
 - **Automated Reports**: Schedule expiration alerts and important changes
@@ -155,15 +178,16 @@ Read our [Security Whitepaper](security/whitepaper.md) for deeper technical deta
 
 ## 📚 Documentation
 
-RDAPify provides comprehensive documentation:
+RDAPify provides comprehensive documentation in the repository:
 
-- **[Getting Started](docs/getting_started/)** - Installation and first query
-- **[API Reference](docs/api_reference/)** - Complete TypeScript documentation
-- **[Core Concepts](docs/core_concepts/)** - RDAP fundamentals and architecture
-- **[Security Guide](docs/security/)** - SSRF protection and PII redaction
-- **[Guides](docs/guides/)** - Error handling, caching, performance
+- **[Getting Started](docs/getting_started/)** - Installation, quick start, and first query
+- **[API Reference](docs/api_reference/)** - Complete TypeScript API documentation
+- **[Core Concepts](docs/core_concepts/)** - RDAP fundamentals, architecture, and normalization
+- **[Security Guide](docs/security/)** - SSRF protection, PII redaction, and best practices
+- **[Guides](docs/guides/)** - Error handling, caching strategies, and performance optimization
+- **[Examples](examples/)** - Real-world code examples and use cases
 
-> **Note**: Full documentation site (rdapify.com) is planned for future release. For now, browse the [docs/](docs/) directory.
+> **Note**: Full documentation site is planned for future release. For now, browse the [docs/](docs/) directory in the repository.
 
 ## 🌐 Interactive Playground
 
@@ -177,11 +201,22 @@ RDAPify provides comprehensive documentation:
 
 RDAPify is an open source project. Get help or contribute:
 
-- **[GitHub Issues](https://github.com/rdapify/rdapify/issues)** - Bug reports and feature requests
-- **[GitHub Discussions](https://github.com/rdapify/rdapify/discussions)** - Questions and ideas
+### 🐛 Bug Reports & Feature Requests
+- **[GitHub Issues](https://github.com/rdapify/RDAPify/issues)** - Report bugs or request features
+
+### 💬 Questions & Discussions
+- **[GitHub Discussions](https://github.com/rdapify/RDAPify/discussions)** - Ask questions, share ideas, and show what you've built
+
+### 📧 Direct Contact
+- **General inquiries**: contact@rdapify.com
+- **Security issues**: security@rdapify.com (see [SECURITY.md](SECURITY.md))
+- **Support**: support@rdapify.com
+
+### 🤝 Contributing
 - **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guidelines
+- **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** - Community standards
 
-> **Note**: Community chat and enterprise support options are planned for future releases.
+> **Enterprise Support**: For SLA-backed support, consulting, or custom features, contact enterprise@rdapify.com
 
 ## 🤝 Contributing
 
@@ -196,11 +231,11 @@ Start by reading our [Contribution Guide](CONTRIBUTING.md) and [Code of Conduct]
 
 ## 🚧 Project Status
 
-**Current Release**: v0.1.0-alpha.1 (Alpha)
+**Current Release**: v0.1.0 (Stable)
 
-### ✅ What's Ready in v0.1.0-alpha.1
+### ✅ What's Ready in v0.1.0
 
-Core functionality is implemented and tested:
+Core functionality is production-ready and fully tested:
 
 - ✅ **RDAP Client**: Domain, IP, and ASN queries with automatic bootstrap discovery
 - ✅ **SSRF Protection**: Blocks private IPs, localhost, link-local, with proper CIDR matching (IPv4/IPv6)
@@ -210,22 +245,99 @@ Core functionality is implemented and tested:
 - ✅ **Error Handling**: Structured errors with retry logic (exponential backoff)
 - ✅ **TypeScript Support**: Full type definitions and strict mode
 - ✅ **Test Coverage**: 146 tests passing (unit + integration with mocked fixtures)
-- ✅ **Node.js Support**: Tested on Node.js 16+
+- ✅ **Node.js Support**: Verified working (CommonJS + ESM imports functional)
 
-### 🔄 Alpha Limitations
+### 🔄 Planned Features
 
-These features are documented but not yet implemented:
+These features are planned for future releases:
 
-- ⏳ **Redis/External Cache**: Only in-memory cache available
-- ⏳ **CLI Tool**: Not yet available (use programmatic API only)
-- ⏳ **Interactive Playground**: Coming in future release
-- ⏳ **Bun/Deno/Cloudflare Workers**: Not tested yet (Node.js only for now)
-- ⏳ **Advanced Analytics**: Dashboard and reporting features planned
-- ⏳ **Geo-distributed Caching**: Single-node caching only
+- ⏳ **Redis/External Cache**: External cache adapters coming in v0.2.0
+- ⏳ **CLI Tool**: Command-line interface planned
+- ⏳ **Interactive Playground**: Web-based testing environment
+- ⏳ **Bun/Deno/Cloudflare Workers**: Additional runtime support
+- ⏳ **Advanced Analytics**: Dashboard and reporting features
+- ⏳ **Geo-distributed Caching**: Multi-region cache support
 
 ### 📋 Roadmap to v0.2.0
 
 - Redis cache adapter
+- CLI tool
+- Rate limiting improvements
+- Batch processing optimization
+
+See [ROADMAP.md](ROADMAP.md) for the complete roadmap.
+
+## 🏗️ Code Architecture
+
+RDAPify follows a clean, modular architecture with clear separation of concerns:
+
+### Source Structure (`/src`)
+
+```
+src/
+├── client/           # Client orchestration layer
+│   ├── RDAPClient.ts          # Main client (242 LOC)
+│   └── QueryOrchestrator.ts   # Query pattern extraction (169 LOC)
+│
+├── fetcher/          # HTTP and registry discovery
+│   ├── Fetcher.ts             # HTTP client (196 LOC)
+│   ├── BootstrapDiscovery.ts  # IANA bootstrap (224 LOC)
+│   └── SSRFProtection.ts      # Security validation (219 LOC)
+│
+├── normalizer/       # Data transformation
+│   ├── Normalizer.ts          # Response normalization (239 LOC)
+│   └── PIIRedactor.ts         # Privacy protection (140 LOC)
+│
+├── cache/            # Caching layer
+│   ├── CacheManager.ts        # Cache orchestration (188 LOC)
+│   └── InMemoryCache.ts       # LRU implementation (185 LOC)
+│
+├── types/            # TypeScript definitions
+│   ├── enums.ts               # Type aliases (87 LOC)
+│   ├── entities.ts            # Entity interfaces (74 LOC)
+│   ├── responses.ts           # Response types (100 LOC)
+│   ├── errors.ts              # Error classes (154 LOC)
+│   ├── options.ts             # Configuration types (201 LOC)
+│   └── index.ts               # Barrel export (36 LOC)
+│
+└── utils/            # Utilities
+    ├── validators/            # Input validation
+    │   ├── domain.ts          # Domain validation (55 LOC)
+    │   ├── ip.ts              # IP validation (86 LOC)
+    │   ├── asn.ts             # ASN validation (42 LOC)
+    │   └── network.ts         # Network utilities (76 LOC)
+    │
+    └── helpers/               # Helper functions
+        ├── async.ts           # Async utilities (77 LOC)
+        ├── string.ts          # String manipulation (38 LOC)
+        ├── object.ts          # Object utilities (33 LOC)
+        ├── cache.ts           # Cache helpers (11 LOC)
+        ├── http.ts            # HTTP utilities (25 LOC)
+        ├── format.ts          # Formatting (27 LOC)
+        └── runtime.ts         # Runtime detection (47 LOC)
+```
+
+### Key Design Principles
+
+1. **Modular Architecture**: Each file has a single, clear responsibility
+2. **Small Files**: All files <250 LOC for easy maintenance
+3. **Type Safety**: Strict TypeScript with explicit types throughout
+4. **Testability**: 146 tests with >90% coverage
+5. **Security First**: SSRF protection and PII redaction built-in
+6. **Performance**: Smart caching and optimized parsing
+
+### Recent Improvements (Phase 2 Refactoring)
+
+- ✅ Extracted QueryOrchestrator from RDAPClient (-29% LOC)
+- ✅ Split validators into focused modules (-87% in main file)
+- ✅ Split helpers into focused modules (-80% in main file)
+- ✅ Split types into enums, entities, responses (-87% in main file)
+- ✅ 712 lines of duplication eliminated
+- ✅ 100% backward compatible (re-export shims)
+
+See [REFACTOR_STATUS.md](REFACTOR_STATUS.md) for detailed refactoring progress.
+
+### 📋 Roadmap to v0.2.0 (Continued)
 - CLI tool with interactive mode
 - Bun/Deno runtime compatibility testing
 - Live integration tests (optional via LIVE_TESTS=1)
@@ -234,6 +346,44 @@ These features are documented but not yet implemented:
 
 **Want to contribute?** Check out our [CONTRIBUTING.md](CONTRIBUTING.md) and [ROADMAP.md](ROADMAP.md)!
 
+## 🔍 Version Verification
+
+RDAPify intentionally does **not** export `./package.json` in the package exports for security and API surface minimization. Attempting to import it will throw an expected error:
+
+```javascript
+// ❌ This will throw ERR_PACKAGE_PATH_NOT_EXPORTED (expected behavior)
+const pkg = require('rdapify/package.json');
+// Error: Package subpath './package.json' is not defined by "exports"
+```
+
+### Safe Version Verification Methods
+
+**Method 1: Using npm (recommended)**
+```bash
+npm ls rdapify
+# Output: rdapify@0.1.0
+```
+
+**Method 2: Programmatic check via require.resolve**
+```javascript
+const fs = require('fs');
+const path = require('path');
+
+const entry = require.resolve('rdapify');
+const pkgPath = path.join(path.dirname(entry), '..', 'package.json');
+const version = JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version;
+
+console.log('rdapify version:', version);
+// Output: 0.1.0
+```
+
+**Method 3: Check installed version in package.json**
+```bash
+cat node_modules/rdapify/package.json | grep version
+```
+
+This design decision prevents accidental exposure of internal package metadata and maintains a minimal public API surface.
+
 ## 🏢 Early Adopters & Feedback
 
 We're looking for early adopters and beta testers! If you're interested in:
@@ -241,8 +391,21 @@ We're looking for early adopters and beta testers! If you're interested in:
 - Testing the library in your environment
 - Providing feedback on the API design
 - Contributing to the codebase
+- Reporting bugs or suggesting features
+
+**Get involved**: 
+- 🌐 Visit our website: [rdapify.com](https://rdapify.com)
+- 🐛 Open a [GitHub Issue](https://github.com/rdapify/RDAPify/issues) for bugs or feature requests
+- 💬 Start a [GitHub Discussion](https://github.com/rdapify/RDAPify/discussions) for questions or ideas
+- 📖 Read the [Documentation](https://rdapify.com/docs)
+- 🤝 Check out [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines
+
+### Known Issues & Limitations
 
-**Get involved**: Open a [GitHub Issue](https://github.com/rdapify/rdapify/issues) or [Discussion](https://github.com/rdapify/rdapify/discussions)
+- Only in-memory caching available (Redis adapter planned for v0.2.0)
+- No CLI tool yet (programmatic API only)
+- Bun/Deno/Cloudflare Workers compatibility not yet tested
+- Live RDAP server tests disabled by default (use `LIVE_TESTS=1` to enable)
 
 ## 📜 License
 

package/dist/{client → application/client}/RDAPClient.d.ts

@@ -1,5 +1,5 @@
-import type { DomainResponse, IPResponse, ASNResponse } from '../types';
-import type { RDAPClientOptions } from '../types/options';
+import type { DomainResponse, IPResponse, ASNResponse } from '../../shared/types';
+import type { RDAPClientOptions } from '../../shared/types/options';
 export declare class RDAPClient {
     private readonly options;
     private readonly cache;
@@ -8,6 +8,7 @@ export declare class RDAPClient {
     private readonly bootstrap;
     private readonly normalizer;
     private readonly piiRedactor;
+    private readonly orchestrator;
     constructor(options?: RDAPClientOptions);
     domain(domain: string): Promise<DomainResponse>;
     ip(ip: string): Promise<IPResponse>;

package/dist/application/client/RDAPClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RDAPClient.d.ts","sourceRoot":"","sources":["../../../src/application/client/RDAPClient.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGlF,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,4BAA4B,CAAC;AAkBpC,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;gBAErC,OAAO,GAAE,iBAAsB;IA2ErC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAiB/C,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAOvC,cAAc;IA0C5B,OAAO,CAAC,gBAAgB;IAOlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,OAAO,CAAC;YACjB,GAAG,EAAE,MAAM,CAAC;SACb,CAAC;QACF,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,EAAE,CAAC;SACjB,CAAC;KACH,CAAC;IAUF,SAAS,IAAI,QAAQ,CAAC,iBAAiB,CAAC;CAGzC"}

package/dist/application/client/RDAPClient.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RDAPClient = void 0;
+const cache_1 = require("../../infrastructure/cache");
+const http_1 = require("../../infrastructure/http");
+const http_2 = require("../../infrastructure/http");
+const security_1 = require("../../infrastructure/security");
+const http_3 = require("../../infrastructure/http");
+const security_2 = require("../../infrastructure/security");
+const errors_1 = require("../../shared/errors");
+const options_1 = require("../../shared/types/options");
+const helpers_1 = require("../../shared/utils/helpers");
+const services_1 = require("../services");
+class RDAPClient {
+    constructor(options = {}) {
+        this.options = this.normalizeOptions(options);
+        const ssrfOptions = typeof this.options.ssrfProtection === 'boolean'
+            ? { enabled: this.options.ssrfProtection }
+            : this.options.ssrfProtection;
+        this.ssrfProtection = new security_1.SSRFProtection(ssrfOptions);
+        this.fetcher = new http_2.Fetcher({
+            timeout: typeof this.options.timeout === 'number'
+                ? {
+                    request: this.options.timeout,
+                    connect: this.options.timeout,
+                    dns: this.options.timeout,
+                }
+                : this.options.timeout,
+            userAgent: this.options.userAgent,
+            headers: this.options.headers,
+            followRedirects: this.options.followRedirects,
+            maxRedirects: this.options.maxRedirects,
+            ssrfProtection: this.ssrfProtection,
+        });
+        this.bootstrap = new http_1.BootstrapDiscovery(this.options.bootstrapUrl, this.fetcher);
+        const cacheOptions = typeof this.options.cache === 'boolean'
+            ? this.options.cache
+                ? options_1.DEFAULT_OPTIONS.cache
+                : { strategy: 'none' }
+            : this.options.cache;
+        this.cache = new cache_1.CacheManager(cacheOptions);
+        this.normalizer = new http_3.Normalizer();
+        const privacyOptions = typeof this.options.privacy === 'boolean'
+            ? { redactPII: this.options.privacy }
+            : this.options.privacy;
+        this.piiRedactor = new security_2.PIIRedactor(privacyOptions);
+        this.orchestrator = new services_1.QueryOrchestrator({
+            cache: this.cache,
+            bootstrap: this.bootstrap,
+            fetcher: this.fetcher,
+            normalizer: this.normalizer,
+            piiRedactor: this.piiRedactor,
+            includeRaw: this.options.includeRaw,
+            fetchWithRetry: this.fetchWithRetry.bind(this),
+        });
+    }
+    async domain(domain) {
+        return this.orchestrator.queryDomain(domain);
+    }
+    async ip(ip) {
+        return this.orchestrator.queryIP(ip);
+    }
+    async asn(asn) {
+        return this.orchestrator.queryASN(asn);
+    }
+    async fetchWithRetry(url) {
+        const retryOptions = typeof this.options.retry === 'boolean'
+            ? this.options.retry
+                ? options_1.DEFAULT_OPTIONS.retry
+                : { maxAttempts: 1 }
+            : this.options.retry;
+        let lastError;
+        for (let attempt = 1; attempt <= (retryOptions.maxAttempts || 1); attempt++) {
+            try {
+                return await this.fetcher.fetch(url);
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof errors_1.ValidationError) {
+                    throw error;
+                }
+                if (attempt < (retryOptions.maxAttempts || 1)) {
+                    const delay = (0, helpers_1.calculateBackoff)(attempt, retryOptions.backoff || 'exponential', retryOptions.initialDelay || 1000, retryOptions.maxDelay || 10000);
+                    await (0, helpers_1.sleep)(delay);
+                    continue;
+                }
+            }
+        }
+        throw lastError;
+    }
+    normalizeOptions(options) {
+        return (0, helpers_1.deepMerge)(options_1.DEFAULT_OPTIONS, options);
+    }
+    async clearCache() {
+        await this.cache.clear();
+        this.bootstrap.clearCache();
+    }
+    async getStats() {
+        return {
+            cache: await this.cache.getStats(),
+            bootstrap: this.bootstrap.getCacheStats(),
+        };
+    }
+    getConfig() {
+        return { ...this.options };
+    }
+}
+exports.RDAPClient = RDAPClient;
+//# sourceMappingURL=RDAPClient.js.map

package/dist/application/client/RDAPClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RDAPClient.js","sourceRoot":"","sources":["../../../src/application/client/RDAPClient.ts"],"names":[],"mappings":"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"}

package/dist/application/client/index.d.ts

@@ -0,0 +1,2 @@
+export { RDAPClient } from './RDAPClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/application/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/application/client/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/application/client/index.js

@@ -0,0 +1,6 @@
+"use strict";
+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/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/application/client/index.ts"],"names":[],"mappings":";;;AAKA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA"}

package/dist/application/services/QueryOrchestrator.d.ts

@@ -0,0 +1,23 @@
+import type { CacheManager } from '../../infrastructure/cache';
+import type { BootstrapDiscovery } from '../../infrastructure/http';
+import type { Fetcher } from '../../infrastructure/http';
+import type { Normalizer } from '../../infrastructure/http';
+import type { PIIRedactor } from '../../infrastructure/security';
+import type { DomainResponse, IPResponse, ASNResponse } from '../../shared/types';
+export interface QueryOrchestratorConfig {
+    cache: CacheManager;
+    bootstrap: BootstrapDiscovery;
+    fetcher: Fetcher;
+    normalizer: Normalizer;
+    piiRedactor: PIIRedactor;
+    includeRaw: boolean;
+    fetchWithRetry: (url: string) => Promise<any>;
+}
+export declare class QueryOrchestrator {
+    private readonly config;
+    constructor(config: QueryOrchestratorConfig);
+    queryDomain(domain: string): Promise<DomainResponse>;
+    queryIP(ip: string): Promise<IPResponse>;
+    queryASN(asn: string | number): Promise<ASNResponse>;
+}
+//# sourceMappingURL=QueryOrchestrator.d.ts.map

package/dist/application/services/QueryOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/application/services/QueryOrchestrator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAclF,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC/C;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,MAAM,EAAE,uBAAuB;IAOrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAwCpD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2CxC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAoC3D"}