Luminara

💡 Philosophy

One Light. Infinite Spectrum. Luminara is a single beam containing every color — a unified, weightless ray that brings clarity to your HTTP flow.

Simplicity First. Built on native fetch, extended by modular drivers and graceful extensions. Minimal by design, powerful by intention.

Made for Builders. Readable APIs, intuitive flow, self-documenting code. Everything designed to help you focus on what truly matters — the craft.

Illuminate Your Path. From retries and interceptors to rate-limits and custom drivers, every feature shines together in perfect balance — one spectrum, one light. ✨

✨ Features

⚡ Core Architecture

Built on modern native fetch - Zero external dependencies
Universal compatibility - Browsers + Node.js 18+ with native fetch
Framework-agnostic - Works with React, Vue, Angular, Svelte, vanilla JS, and Node.js
Domain-driven architecture - Feature-based modular structure
Dual export support - ESM/CJS compatibility with auto-detection
Extensible driver architecture - Custom drivers via forking
Ultra-compact footprint
Zero dependencies - Truly standalone
Same API everywhere - Identical behavior in all environments

🔄 Request Lifecycle (Orchestration Layer)

Enhanced interceptor architecture - Deterministic order, mutable context, retry-aware
Plugin system - Extensible architecture with official plugins (cookie-jar)
Comprehensive stats system - Real-time metrics, analytics, and query interface
Verbose logging system - Detailed debugging and request tracing

🚀 Pre-Flight Features (Request Dispatcher - Phase 1)

Request deduplication - Automatic in-flight duplicate request prevention
Request debouncing - Intelligent request delay with automatic cancellation
Advanced rate limiting - Token bucket algorithm with global, domain, and endpoint scoping

⚡ In-Flight Features (Request Execution - Phase 2)

Configurable timeouts - Request timeouts and abort controller support
Comprehensive retry system - 6 backoff strategies (exponential, fibonacci, jitter, etc.)
Request hedging - Race and cancel-and-retry policies for latency optimization

🎯 Post-Flight Features (Response Handlers - Phase 3)

Response type handling - JSON, text, form data, binary support
Robust error handling - Comprehensive error categorization and handling

🧪 Battle-Tested Reliability

234 tests across 16 test suites (100% passing)
Programmatic validation - Tests actual behavior, not just API contracts
Framework simulation - React, Vue, Angular usage patterns
Timing accuracy - Backoff strategies validated to millisecond precision
Integration testing - Feature combinations (retry + timeout + hedging)

⚡ Performance & Benchmarks

68 Node.js benchmarks - High-precision measurements with memory profiling
18 browser benchmarks - Automated headless testing across Chromium, Firefox, and WebKit
Microsecond-scale core - Client creation ~7.5µs, plugin registration ~0.16µs
Sub-millisecond orchestration - Full pipeline execution stays under 0.2ms
Network parity - Single request ~2.35ms (bare), ~2.67ms (all features) = 0.32ms overhead