๐ŸŒŒ

Luminara

One beam of light revealing what HTTP clients were meant to be -
Not just another wrapper, but a complete vision

๐Ÿ’ก 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)

๐Ÿš€ Pre-Flight Features (Request Dispatcher - Phase 1)

โšก In-Flight Features (Request Execution - Phase 2)

๐ŸŽฏ Post-Flight Features (Response Handlers - Phase 3)

๐Ÿงช 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