rdapify 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,150 @@
+# Changelog
+
+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
+- Cancel timeout timer in `withTimeout()` to prevent Jest exit warning
+- Improve integration test fetch mock cleanup with proper `beforeEach`/`afterEach`
+
+## [0.1.0-alpha.1] - 2026-01-22
+
+### Added
+- Initial alpha 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
+- 146 unit and integration tests with mocked fixtures
+
+### 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
+
+### Known Limitations
+- Redis cache not yet implemented (in-memory only)
+- No CLI tool in this release
+- Bun/Deno/Cloudflare Workers support untested
+- Live integration tests not included in CI
+- Documentation references features not yet available
+
+### Dependencies
+- ipaddr.js: ^2.2.0 (for CIDR matching)
+- tslib: ^2.8.1 (TypeScript runtime)
+
+### Development
+- TypeScript 5.3.3 with strict mode
+- Jest for testing
+- ESLint for code quality
+- Prettier for code formatting
+
+## [Unreleased]
+
+### Planned for v0.2.0
+- Redis cache implementation
+- CLI tool for quick queries
+- Live integration tests
+- Improved error messages
+- Performance benchmarks
+- Additional runtime support (Bun, Deno)
+
+---
+
+[0.1.0-alpha.1]: https://github.com/rdapify/rdapify/releases/tag/v0.1.0-alpha.1

package/README.md

@@ -1,10 +1,12 @@
 # RDAPify - Unified, Secure, High-Performance RDAP Client for Enterprise Applications
 
+> **🎉 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)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/rdapify/rdapify/ci.yml?branch=main&style=flat-square)](https://github.com/rdapify/rdapify/actions)
-[![Coverage](https://img.shields.io/codecov/c/github/rdapify/rdapify?style=flat-square)](https://codecov.io/gh/rdapify/rdapify)
-[![Security](https://img.shields.io/badge/security-SSRF%20Protected-brightgreen?style=flat-square)](SECURITY.md) 
+[![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.
 
@@ -23,10 +25,11 @@ Direct RDAP queries are complex — each registry uses different formats, rate l
 ```
 
 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
@@ -40,25 +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');
@@ -68,12 +69,35 @@ console.log({
   registrar: result.registrar?.name,
   status: result.status,
   nameservers: result.nameservers,
-  created: result.events.find(e => e.type === 'created')?.date,
-  expires: result.events.find(e => e.type === 'expiration')?.date
+  created: result.events.find((e) => e.type === 'created')?.date,
+  expires: result.events.find((e) => e.type === 'expiration')?.date,
+});
+```
+
+### 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');
 ```
 
-**Output:**
+**Example Output:**
+
 ```json
 {
   "domain": "example.com",
@@ -88,6 +112,7 @@ console.log({
 ## 🌟 Core Features
 
 ### 🔒 Enterprise Security
+
 - **Built-in SSRF Protection**: Prevent queries to internal IP addresses or dangerous domains
 - **Certificate Validation**: Reject insecure connections to RDAP servers
 - **Rate Limiting**: Prevent service blocking due to excessive requests
@@ -95,20 +120,25 @@ console.log({
 - **Full Audit Trail**: Track all critical operations for compliance purposes
 
 ### ⚡ 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)
+
+Future releases will include:
 
-### 📊 Advanced Analytics
 - **Customizable Dashboards**: Track critical domains and assets
 - **Automated Reports**: Schedule expiration alerts and important changes
 - **Pattern Detection**: Identify suspicious registration behaviors or potential attacks
@@ -136,60 +166,62 @@ style G fill:#2196F3,stroke:#0D47A1
 
 We don't treat security as an add-on feature — it's fundamental to our design. RDAPify protects your applications from:
 
-| Threat | Protection Mechanism | Criticality |
-|--------|----------------------|-------------|
-| SSRF | Domain validation, blocking internal IPs | 🔴 Critical |
-| DoS | Rate limiting, timeouts | 🟠 Important |
-| Data Leaks | PII redaction, no raw response storage | 🔴 Critical |
-| MitM | Mandatory HTTPS, certificate validation | 🟠 Important |
-| Data Injection | Schema validation, strict parsing | 🟠 Important |
+| Threat         | Protection Mechanism                     | Criticality  |
+| -------------- | ---------------------------------------- | ------------ |
+| SSRF           | Domain validation, blocking internal IPs | 🔴 Critical  |
+| DoS            | Rate limiting, timeouts                  | 🟠 Important |
+| Data Leaks     | PII redaction, no raw response storage   | 🔴 Critical  |
+| MitM           | Mandatory HTTPS, certificate validation  | 🟠 Important |
+| Data Injection | Schema validation, strict parsing        | 🟠 Important |
 
 Read our [Security Whitepaper](security/whitepaper.md) for deeper technical details and advanced scenarios.
 
-## 📚 Comprehensive Documentation
+## 📚 Documentation
 
-RDAPify provides enterprise-grade documentation covering every scenario:
+RDAPify provides comprehensive documentation in the repository:
 
-- **[Getting Started](docs/getting-started/)** - Start in 5 minutes
-- **[Playground](docs/playground/)** - Try the library in your browser
-- **[API Reference](docs/api-reference/)** - Complete TypeScript documentation
-- **[Security & Privacy](docs/security/)** - Enterprise security guide
-- **[Integrations](docs/integrations/)** - Pre-built cloud platform templates
-- **[Enterprise Guide](docs/enterprise/)** - Production best practices
-- **[Analytics](docs/analytics/)** - Dashboard and reporting recipes
+- **[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
 
-[→ View Full Documentation](https://rdapify.dev)
+> **Note**: Full documentation site is planned for future release. For now, browse the [docs/](docs/) directory in the repository.
 
 ## 🌐 Interactive Playground
 
-No installation needed! Try RDAPify instantly in our [Playground](https://playground.rdapify.dev):
-
-![Screenshot of RDAPify Playground](https://rdapify.dev/images/playground-screenshot.png)
+> **Coming Soon**: Interactive playground is planned for a future release. For now, install the package and try the examples in the [docs/](docs/) directory.
 
 ## 📊 Performance Benchmarks
 
-### Comparison with Alternatives (1000 queries)
-| Library | Time (seconds) | Memory Usage | Avg Response Time |
-|---------|----------------|--------------|-------------------|
-| **RDAPify** | **3.2** | **85 MB** | **1.8 ms** |
-| rdap-client | 42.7 | 310 MB | 214 ms |
-| node-rdap | 58.1 | 420 MB | 290 ms |
-| whois-json | 196.5 | 580 MB | 982 ms |
-
-> Benchmarks run on Node.js 20, Intel i7, 32GB RAM, 1Gbps connection. Includes caching benefits.
+> **Coming Soon**: Comprehensive benchmarks with real-world data will be published in future releases. Current alpha focuses on correctness and security over performance optimization.
 
 ## 👥 Community & Support
 
-RDAPify is an open source project supported by organizations and developers worldwide:
+RDAPify is an open source project. Get help or contribute:
+
+### 🐛 Bug Reports & Feature Requests
+- **[GitHub Issues](https://github.com/rdapify/RDAPify/issues)** - Report bugs or request features
 
-- **[Matrix/Element](https://matrix.to/#/#rdapify:matrix.org)** - Live chat with developers
-- **[GitHub Discussions](https://github.com/rdapify/rdapify/discussions)** - Questions and ideas
-- **[Weekly Office Hours](https://rdapify.dev/community/office-hours)** - Live sessions every Thursday
-- **[Enterprise Support](https://rdapify.dev/enterprise)** - SLA-backed support for businesses
+### 💬 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
+
+> **Enterprise Support**: For SLA-backed support, consulting, or custom features, contact enterprise@rdapify.com
 
 ## 🤝 Contributing
 
 We welcome contributions! Whether you're a:
+
 - Developer wanting to fix bugs or add features
 - Writer improving documentation
 - Tester reporting issues
@@ -197,16 +229,183 @@ We welcome contributions! Whether you're a:
 
 Start by reading our [Contribution Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
 
-## 🏢 Enterprise Adoption
+## 🚧 Project Status
+
+**Current Release**: v0.1.0 (Stable)
+
+### ✅ What's Ready in v0.1.0
+
+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)
+- ✅ **Data Normalization**: Consistent response format across all registries
+- ✅ **PII Redaction**: Automatic redaction of emails, phones, addresses
+- ✅ **In-Memory Caching**: LRU cache with TTL support
+- ✅ **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**: Verified working (CommonJS + ESM imports functional)
+
+### 🔄 Planned Features
+
+These features are planned for future releases:
+
+- ⏳ **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)
+- Performance benchmarks with real data
+- Rate limiting implementation
+
+**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:
+
+- Testing the library in your environment
+- Providing feedback on the API design
+- Contributing to the codebase
+- Reporting bugs or suggesting features
 
-The following companies use RDAPify in production systems:
+**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
 
-[![Enterprise Logo 1](https://via.placeholder.com/120x40?text=Enterprise1)](https://example.com)
-[![Enterprise Logo 2](https://via.placeholder.com/120x40?text=Enterprise2)](https://example.com)
-[![Enterprise Logo 3](https://via.placeholder.com/120x40?text=Enterprise3)](https://example.com)
-[![Enterprise Logo 4](https://via.placeholder.com/120x40?text=Enterprise4)](https://example.com)
+### Known Issues & Limitations
 
-**Using RDAPify at your company?** [Let us know](https://rdapify.dev/companies) to be added to our list.
+- 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
 
@@ -220,5 +419,5 @@ We thank the global RDAP community, IANA teams, and Regional Internet Registry (
 
 > **Note:** RDAPify is an independent project not affiliated with any domain registry or official internet authority. All trademarks and products mentioned are property of their respective owners.
 >
-> © 2025 RDAPify — Built for enterprises that don't compromise on quality and security.  
-> [Security Policy](SECURITY.md) • [Privacy Policy](PRIVACY.md) • [Contact Us](mailto:hello@rdapify.dev)
+> © 2025 RDAPify Contributors — Built for enterprises that don't compromise on quality and security.  
+> [Security Policy](SECURITY.md) • [Privacy Policy](PRIVACY.md) • [License](LICENSE)

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

@@ -0,0 +1,32 @@
+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;
+    private readonly fetcher;
+    private readonly ssrfProtection;
+    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>;
+    asn(asn: string | number): Promise<ASNResponse>;
+    private fetchWithRetry;
+    private normalizeOptions;
+    clearCache(): Promise<void>;
+    getStats(): Promise<{
+        cache: {
+            size: number;
+            enabled: boolean;
+            ttl: number;
+        };
+        bootstrap: {
+            size: number;
+            types: string[];
+        };
+    }>;
+    getConfig(): Required<RDAPClientOptions>;
+}
+//# sourceMappingURL=RDAPClient.d.ts.map

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"}