rdapify 0.1.3 → 0.1.7

package/CHANGELOG.md

@@ -5,7 +5,93 @@ 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]
+## [Unreleased] — v0.1.8 Planned
+
+### Planned
+- **Domain Availability**: `client.checkAvailability(domain)` — check if a domain is available via RDAP (404 = available, active = registered)
+- **Bulk Availability**: `client.checkAvailabilityBatch(domains[])` — check multiple domains in parallel
+- **Live Integration Tests**: opt-in via `LIVE_TESTS=1` environment variable
+- **Advanced Bootstrap Config**: custom bootstrap servers, TTL overrides, redundancy/fallback support
+
+## [0.1.7] - 2026-03-19
+
+### Fixed
+
+- **Playground deployment**: `website/static/playground-app/app.js` was out of sync with `playground/public/app.js`; domains returning HTTP 404 now correctly show "Domain Available" instead of an error
+- **Jest forceExit**: Added `forceExit: true` to `jest.config.js` to prevent CI hangs caused by open Redis async handles
+- **redis-cache tests**: Updated tests to match `scanAll()`/`keys()` implementation instead of the removed `dbSize()`/`flushDb()` approach
+
+### Added
+
+- **Nameserver queries**: New `client.nameserver(hostname)` method for querying nameserver RDAP data
+  - Automatic server discovery via IANA DNS TLD bootstrap
+  - Returns `NameserverResponse` with `ldhName`, `ipAddresses`, `status`, `entities`, `events`
+  - Full support for caching, middleware hooks, metrics, deduplication, and PII redaction
+- **Entity queries**: New `client.entity(handle, serverUrl)` method for querying RDAP entity data
+  - Returns `EntityResponse` with `handle`, `vcardArray`, `roles`, `status`, `entities`, `events`
+  - Requires explicit `serverUrl` (no global IANA bootstrap exists for entities)
+  - Full support for caching, middleware hooks, metrics, and deduplication
+- **CLI commands extended**:
+  - `rdapify nameserver <hostname>` — query nameserver RDAP data
+  - `rdapify entity <handle> --server <url>` — query entity RDAP data
+  - New `--server <url>` flag for specifying RDAP server URL
+- **New response types**: `NameserverResponse` and `EntityResponse` exported from main entry point
+- **New validators exported**: `validateNameserver`, `normalizeNameserver`, `validateEntityHandle`, `normalizeEntityHandle`
+- **Normalizer extended**: Handles `nameserver` and `entity` objectClassName values from raw RDAP responses
+- **BootstrapDiscovery extended**: New `discoverNameserver()` method using DNS TLD bootstrap
+
+## [0.1.6] - 2026-03-17
+
+### Added
+
+- **isCloudflareWorkers()**: New runtime detection function for Cloudflare Workers environment
+- **CLI Tool**: New `rdapify` CLI command with zero external dependencies
+  - `rdapify domain <name>` — query domain RDAP data
+  - `rdapify ip <addr>` — query IP RDAP data
+  - `rdapify asn <num>` — query ASN RDAP data
+  - Flags: `--json`, `--no-cache`, `--timeout`
+
+### Fixed
+
+- **RedisCache.clear() (Critical)**: Previously called `flushDb()` which wiped the entire Redis database; now only deletes keys matching the configured prefix using SCAN
+- **RedisCache.size() (Critical)**: Previously used `dbSize()` returning total DB size; now counts only prefixed keys accurately
+- **RedisCache SCAN (Performance)**: Replaced blocking `KEYS` command with non-blocking `SCAN` iteration; added `scanAll()` private helper; added optional `scan?()` to `RedisClientLike` interface; removed unused `flushDb?()` and `dbSize?()` from interface
+- **runtime.ts (Compatibility)**: `isNode()` wrapped with `typeof process !== 'undefined'` guard to prevent `ReferenceError` in Cloudflare Workers
+
+## [0.1.5] - 2026-03-14
+
+### Added
+
+- **RedisCache**: Redis adapter with peer-dependency pattern, compatible with ioredis and node-redis v4+
+- **AuthenticationManager**: Support for Bearer tokens, API keys, Basic auth, and OAuth2
+- **ProxyManager**: HTTP/HTTPS/SOCKS proxy support for RDAP requests
+- **CompressionManager**: gzip/deflate/brotli compression for requests/responses
+- **PersistentCache**: File-system backed cache that survives process restarts
+- **MiddlewareManager**: Full lifecycle hooks — `beforeQuery`, `afterQuery`, `onError`, `onCacheHit`
+- **QueryDeduplicator**: Collapses in-flight duplicate queries into a single upstream request
+- **AuditLogger**: GDPR/SOC2-compliant audit trail with `InMemoryAuditAdapter` and `FileAuditAdapter`
+- **ResponseValidator**: RFC 7483 response validation with strict and lenient modes
+- All new classes exported from main entry point
+
+## [0.1.4] - 2026-03-13
+
+### Added
+
+- **MiddlewareHooks**: Middleware hooks system (`src/application/hooks/MiddlewareHooks.ts`)
+- **QueryDeduplicator**: Initial implementation (`src/application/deduplication/QueryDeduplicator.ts`)
+- **AuditLogger**: Initial implementation (`src/infrastructure/logging/AuditLogger.ts`)
+- **ResponseValidator**: RFC 7483 compliance validation (`src/infrastructure/validation/ResponseValidator.ts`)
+
+### Changed
+
+- **TypeScript strict mode**: Enabled and enforced strict mode improvements across the codebase
+- **Generic types**: Enhanced type safety in `src/shared/types/generics.ts`
+- **QueryPriority**: Improved type safety in `src/application/services/QueryPriority.ts`
+- **BatchProcessor**: Improved type safety in `src/application/services/BatchProcessor.ts`
+
+### Testing
+
+- Additional test coverage for edge cases across existing and new modules
 
 ## [0.1.3] - 2026-03-12
 
@@ -77,17 +163,49 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Multiple package manager support (npm, yarn, pnpm)
   - Integrated into website navigation
   - Production-ready documentation and testing guides
+- **Connection Pooling**: HTTP connection reuse for 30-40% performance improvement
+  - Configurable max connections per host
+  - Automatic idle connection cleanup
+  - Keep-alive support for persistent connections
+- **Metrics & Monitoring**: Comprehensive query metrics tracking
+  - Success/failure rates and response times
+  - Cache hit/miss statistics
+  - Query type distribution (domain/IP/ASN)
+  - Error type tracking
+  - Time-based filtering and analysis
+- **Request/Response Logging**: Detailed logging system with multiple levels
+  - Configurable log levels (debug, info, warn, error)
+  - Request/response logging with timing
+  - Cache operation logging
+  - Performance metrics logging
+  - JSON and text output formats
+  - Log filtering and export capabilities
+- **Client API Extensions**: New methods for monitoring and debugging
+  - `getMetrics()`: Get query metrics summary
+  - `getConnectionPoolStats()`: Get connection pool statistics
+  - `getLogger()`: Access logger instance
+  - `getLogs()`: Retrieve recent logs
+  - `clearAll()`: Clear all caches, metrics, and logs
+  - `destroy()`: Clean up resources
 
 ### Changed
 - Updated website navigation to include Playground link
 - Enhanced documentation for production deployment
+- **QueryOrchestrator**: Integrated logging and metrics collection into all query methods
+- **RDAPClient**: Added connection pool, metrics collector, and logger initialization
 
 ### Fixed
 - ESLint errors in Logger.ts and enhanced-validators.ts (6 issues resolved)
 
+### Tests
+- Added comprehensive test suites for new features:
+  - `connection-pool.test.ts`: 9 tests covering connection management
+  - `metrics-collector.test.ts`: 11 tests covering metrics tracking
+  - `logger.test.ts`: 18 tests covering logging functionality
+
 ## [0.1.1] - 2026-01-25
 
-### Added - Phase 3 Improvements
+### Added
 - **Authentication Support**: Multiple authentication methods for RDAP servers
   - Basic Authentication (username/password)
   - Bearer Token authentication
@@ -105,8 +223,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Automatic response decompression
   - Compression statistics and ratio calculation
   - Configurable compression threshold
-
-### Added - Phase 2 Improvements
 - **Retry Strategies**: Advanced retry logic with circuit breaker pattern
   - Exponential, linear, and fixed backoff strategies
   - Exponential backoff with jitter to prevent thundering herd
@@ -130,85 +246,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - TTL and max size enforcement
   - LRU eviction policy
   - Cache statistics and cleanup
-
-### Changed
-- **Exports**: Added new exports for Phase 2 features in index.ts
-
-### Tests
-- Added comprehensive test suites for Phase 3 features:
-  - `authentication-manager.test.ts`: 17 tests covering all auth methods
-  - `proxy-manager.test.ts`: 16 tests covering proxy configuration
-  - `compression-manager.test.ts`: 19 tests covering compression/decompression
-- Added comprehensive test suites for Phase 2 features:
-  - `retry-strategy.test.ts`: 13 tests covering retry logic and circuit breaker
-  - `query-priority.test.ts`: 8 tests covering priority queue functionality
-  - `enhanced-validators.test.ts`: 21 tests covering validation enhancements
-  - `persistent-cache.test.ts`: 13 tests covering persistent storage
-
-### Performance
-- **Retry Strategies**: Intelligent retry reduces failed requests
-- **Query Prioritization**: Critical queries execute first
-- **Persistent Cache**: Faster startup with pre-loaded cache
-
-## [0.1.2] - 2026-01-26
-
-### Added - Phase 1 Improvements
-- **Connection Pooling**: HTTP connection reuse for 30-40% performance improvement
-  - Configurable max connections per host
-  - Automatic idle connection cleanup
-  - Keep-alive support for persistent connections
-- **Metrics & Monitoring**: Comprehensive query metrics tracking
-  - Success/failure rates and response times
-  - Cache hit/miss statistics
-  - Query type distribution (domain/IP/ASN)
-  - Error type tracking
-  - Time-based filtering and analysis
-- **Request/Response Logging**: Detailed logging system with multiple levels
-  - Configurable log levels (debug, info, warn, error)
-  - Request/response logging with timing
-  - Cache operation logging
-  - Performance metrics logging
-  - JSON and text output formats
-  - Log filtering and export capabilities
-- **Client API Extensions**: New methods for monitoring and debugging
-  - `getMetrics()`: Get query metrics summary
-  - `getConnectionPoolStats()`: Get connection pool statistics
-  - `getLogger()`: Access logger instance
-  - `getLogs()`: Retrieve recent logs
-  - `clearAll()`: Clear all caches, metrics, and logs
-  - `destroy()`: Clean up resources
-
-### Changed
-- **QueryOrchestrator**: Integrated logging and metrics collection into all query methods
-- **RDAPClient**: Added connection pool, metrics collector, and logger initialization
-
-### Tests
-- Added comprehensive test suites for new features:
-  - `connection-pool.test.ts`: 9 tests covering connection management
-  - `metrics-collector.test.ts`: 11 tests covering metrics tracking
-  - `logger.test.ts`: 18 tests covering logging functionality
-
-## [0.1.1] - 2026-01-25
-
-### Added
 - **Rate Limiting**: Token bucket rate limiter with multi-key support and auto-cleanup
 - **Batch Processing**: Efficient concurrent processing of multiple RDAP queries
 - **Enhanced Error Handling**: Errors now include suggestions, timestamps, and user-friendly messages
 - **Generic Types**: Type-safe query functions with automatic result type inference
 - **Tree Shaking Support**: Modular exports for smaller bundle sizes
-- **Comprehensive Tests**: Added 37+ new tests for PIIRedactor, CacheManager, and RateLimiter
 
 ### Changed
+- **Exports**: Added new exports for all Phase 1–3 features in index.ts
 - **Error Classes**: All errors now include `suggestion`, `timestamp`, and `getUserMessage()` method
 - **RateLimitError**: Added `retryAfter` field to indicate when to retry
 - **Package Exports**: Added modular exports for errors, types, and validators
 - **TypeScript Config**: Optimized for better tree shaking and smaller output
-
-### Improved
-- **Test Coverage**: Increased from 76.74% to ~85-90% (estimated)
-- **Type Safety**: Better generic types for query operations
-- **Developer Experience**: More helpful error messages and suggestions
-- **Performance**: Batch processing with configurable concurrency
+- Standardized Node.js version to v20 across all GitHub Actions workflows
+- Updated all workflows to use `node-version-file: .nvmrc` for consistency
+- Improved npm caching in CI/CD workflows for faster builds
+- Added `NODE_ENV: production` to website build workflow
 
 ### Fixed
 - Fixed prism-react-renderer theme import in Docusaurus configuration
@@ -219,19 +272,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixed missing sidebars.js configuration
 - Removed empty pages causing build failures
 
-### Changed
-- Standardized Node.js version to v20 across all GitHub Actions workflows
-- Updated all workflows to use `node-version-file: .nvmrc` for consistency
-- Improved npm caching in CI/CD workflows for faster builds
-- Added `NODE_ENV: production` to website build workflow
-- Added `onBrokenMarkdownImages: 'warn'` to Docusaurus config
-- Enhanced release workflow with better error handling
+### Tests
+- Added comprehensive test suites:
+  - `authentication-manager.test.ts`: 17 tests covering all auth methods
+  - `proxy-manager.test.ts`: 16 tests covering proxy configuration
+  - `compression-manager.test.ts`: 19 tests covering compression/decompression
+  - `retry-strategy.test.ts`: 13 tests covering retry logic and circuit breaker
+  - `query-priority.test.ts`: 8 tests covering priority queue functionality
+  - `enhanced-validators.test.ts`: 21 tests covering validation enhancements
+  - `persistent-cache.test.ts`: 13 tests covering persistent storage
+  - PIIRedactor, CacheManager, and RateLimiter: 37+ new tests
 
-### Added
-- Created SVG placeholder icons for homepage features (typescript, performance, security, multi-env, unified, privacy)
-- Added examples validation workflow
-- Added fork check for Snyk security scans to prevent token exposure
-- Added comprehensive CI/CD fixes documentation
+### Performance
+- **Retry Strategies**: Intelligent retry reduces failed requests
+- **Query Prioritization**: Critical queries execute first
+- **Persistent Cache**: Faster startup with pre-loaded cache
 
 ## [0.1.0] - 2025-01-25
 
@@ -361,16 +416,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 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