Recker

The HTTP SDK for the AI Era

Fast as infrastructure demands. AI-ready from the first byte. Observable down to the millisecond. Resilient when everything else fails.

Documentation · Examples · Migration

📦 Install

npm install recker

🚀 Quick Start

import { createClient } from 'recker';

const client = createClient({ baseUrl: 'https://api.example.com' });

// GET with JSON
const users = await client.get('/users').json();

// POST with body
await client.post('/users', { json: { name: 'John' } });

// Path params + query
await client.get('/users/:id', { params: { id: '123', expand: 'profile' } });

✨ Why Recker?

Recker isn't just another HTTP client. It's a complete orchestration layer designed for modern, data-intensive applications.

💡 Feature Highlights

Stream AI Responses

Handle LLM streams effortlessly with the .sse() iterator.

for await (const event of client.post('/v1/chat/completions', {
  json: { model: 'gpt-5', messages, stream: true }
}).sse()) {
  process.stdout.write(event.data);
}

Scrape & Extract

Turn any webpage into structured data with the .scrape() method.

const doc = await client.scrape('https://example.com');
const titles = doc.selectAll('h1').map(el => el.text());

Reliability Built-in

Configure advanced retry policies in declarative style.

const client = createClient({
  plugins: [
    retry({ maxAttempts: 3, backoff: 'exponential', jitter: true })
  ]
});

Deep Observability

Know exactly where your latency comes from.

const { timings } = await client.get('/api/data');
console.log(timings);
// { dns: 12ms, tcp: 8ms, tls: 45ms, firstByte: 23ms, total: 156ms }

📚 Documentation

Getting Started

• Installation
• Quick Start
• Client Configuration

Core Features

• HTTP Fundamentals
• Streaming & SSE
• Retry & Resilience
• Caching
• Concurrency

Integrations

• GraphQL
• Scraping
• Plugins

Reference

• API Reference
• Troubleshooting
• Examples

❤️ Acknowledgements

At Recker, we are passionate about these incredible open-source technologies. We are here to celebrate the past achievements that shaped the internet as we know it today, and to prepare ourselves for the future of web development.

Recker stands on the shoulders of giants. We extend our deepest gratitude to these projects:

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📄 License

MIT © Forattini