@tripathirajan/fetcher

A modern, universal HTTP client library for TypeScript and JavaScript that supports fetch and XHR fallback, timeouts, retries, interceptors, and progress reporting.

📊 Feature Support

Feature	Browser	Node.js
fetcher.get/post/...	✅	✅
downloadWithProgress()	✅	❌
postWithUploadProgress()	✅	❌

✨ Quickstart

import fetcher from '@tripathirajan/fetcher';
const res = await fetcher.get('https://api.example.com/data');
const json = await res.json();
Copy

📦 Features

• Automatic retries and timeouts
• Request and response interceptors
• Download and upload progress
• Node.js and browser support
• ESM, CJS, and IIFE builds

📥 Installation

npm install @tripathirajan/fetcher
Copy

🚀 Usage Examples

ESM (Node.js or Bundlers)

import fetcher from '@tripathirajan/fetcher';
// example usage here...
Copy

CommonJS

const fetcher = require('@tripathirajan/fetcher').default;
// example usage here...
Copy

IIFE (Browser)

<script src="https://unpkg.com/@tripathirajan/fetcher@<VERSION>/dist/fetcher.min.js"></script>
<script>
  fetcher
    .get('https://api.example.com/data')
    .then((res) => res.json())
    .then((data) => console.log(data));
</script>
Copy

⚙️ API Reference

fetcher.create(config)

Creates a new Fetcher instance.

Config Options

Option	Type	Description
baseURL	string	Base URL for all requests
headers	Record<string, string>	Default headers
timeout	number	Timeout in milliseconds
retries	number	Number of retry attempts
credentials	"omit" | "same-origin" | "include"	Credential policy for cross-origin requests

Methods

All methods return a native Response object. You must call .json(), .text(), etc. to parse.

• get(url, config?)
• post(url, body, config?)
• put(url, body, config?)
• delete(url, config?)
• downloadWithProgress(url, onProgress, config?) (Browser only)
• postWithUploadProgress(url, body, onUploadProgress, config?) (Browser only)

📚 Documentation

Full API documentation:

https://tripathirajan.github.io/fetcher/

🌐 Supported Environments

⚠️ downloadWithProgress and postWithUploadProgress are only available in browser environments and will throw an error if used in Node.js.

• Node.js 16+
• All modern browsers
• Internet Explorer 11 (with polyfills for Fetch/XHR)

📂 Examples

See the examples folder for Node.js and Browser usage.

🛠️ Development

Run all pre-checks before build:

npm run prebuild
Copy

Note: The prebuild script runs automatically before npm run build. It ensures linting, formatting, and tests are successful before generating build output.

🤝 Contributing

Contributions, issues and feature requests are welcome! Feel free to open an issue or submit a pull request.

💖 Support

If you find this library useful, consider starring the repo or buying me a coffee.

🧩 License

MIT © 2025 Rajan Tripathi