docs: rewrite README with professional documentation and update package metadata

Author: softsideof

README.md

@@ -1,70 +1,101 @@
-# FastFetch API Fetch Enhancer 
+# FastFetch API Enhancer
 
-## Description
-FastFetch is an NPM package designed to enhance the `fetch()` function by providing a smarter wrapper with features like auto-retry, deduplication, and minimal boilerplate for efficient API requests. With FastFetch, you can eliminate redundant API calls and seamlessly handle failures thanks to the built-in retry logic using exponential backoff strategy..
+FastFetch is a production-grade, enterprise-ready HTTP client built around the native `fetch` API. It transforms simple HTTP requests into robust network architecture by introducing advanced resilience patterns, high-concurrency request management, and real-time streaming capabilities without excessive boilerplate.
 
-## Features
-- **Auto-Retry**: Automatic retries for failed API requests using an exponential backoff strategy.
-- **Deduplication**: Avoid duplicate API calls by caching requests and returning the same response when multiple requests for the same resource are made simultaneously.
-- **Efficiency**: Minimal boilerplate code needed to make API requests, making the process faster and easier.
-- **Reliability**: Built-in retry logic ensures that failed requests are retried intelligently without manual intervention.
+## Architecture & Features
 
-## Topics
-api, api-fetch, api-rest, auto-retry, axios, cache, deduplication, exponential-backoff, fast-fetch, fetch, fetch-api, fetch-data, frontend, ghost-cache, node-package-manager, nodejs, npm, npm-package, retry, smart-api
+FastFetch v2 provides seven core execution pipelines directly into your fetch workflow:
 
-## Repository Link
-[![Download https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases](https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases)](https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases "Needs to be launched from the link")
+- **Strict Typed Error Hierarchy:** Explicit errors for `TimeoutError`, `NetworkError`, `HttpError`, and `CircuitOpenError` enabling robust try/catch control flow.
+- **Koa-Style Middleware Pipeline:** A powerful `.use(async (ctx, next) => {})` onion-model interceptor architecture for modifying request metadata or observing response execution duration.
+- **Finite State Machine Circuit Breaker:** Stops cascading failures to downstream services by automatically failing fast when failure thresholds are breached, entering a `HALF_OPEN` state after the configured timeout.
+- **Priority-Aware Concurrency Queue:** Protects API rate limits by enforcing a strict `maxConcurrent` ceiling across all ongoing requests while maintaining execution priority.
+- **Offline Mutation Buffering:** Automatically buffers mutating requests (`POST`, `PUT`, `PATCH`, `DELETE`) internally if the browser detects an offline state, sequentially replaying them upon reconnection.
+- **Real-Time Telemetry & Metrics:** Maintains rolling windows on p50, p95, and p99 latency percentiles alongside exact endpoint success and failure ratios.
+- **Server-Sent Events (SSE) Native Streaming:** A built-in high-performance stream consumer utilizing `api.stream()` for interacting with AI models and event-driven backends natively over HTTP.
 
-For more information, please visit the repository's [Releases](https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases) section.
+## Installation
 
----
-
-Welcome to the FastFetch API Fetch Enhancer repository! FastFetch is your go-to solution for optimizing API requests in your https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases projects. Whether you are building web applications, frontend interfaces, or working with backend services, FastFetch has got you covered.
-
-### Getting Started
-To start using FastFetch in your project, follow these simple steps:
-1. Install FastFetch via NPM:
 ```bash
-npm install fast-fetch
-```
-2. Incorporate FastFetch in your script:
-```javascript
-const fastFetch = require('fast-fetch');
-```
-3. Begin making efficient API calls using FastFetch:
-```javascript
-fastFetch('https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases')
-    .then(response => https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases(response))
-    .catch(err => https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases(err));
+npm install fastfetch-api-fetch-enhancer
 ```
 
-### Advanced Features
-FastFetch comes with a set of advanced features to enhance your API request handling:
-- **Auto-Retry**: Don't worry about failed requests, FastFetch will automatically retry with exponential backoff.
-- **Deduplication**: Avoid duplicate API calls by fetching the same response when multiple requests for the same resource are made.
-- **Caching**: Ghost-caching ensures that responses are stored for quicker access in subsequent requests.
-- **Error Handling**: Easily manage and catch errors in your API requests with built-in retry logic.
-
-### Example Usage
-```javascript
-const fetchData = async () => {
-    try {
-        const data = await fastFetch('https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases');
-        https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases(data);
-    } catch (error) {
-        https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases(error);
+## Basic Usage
+
+A minimal example utilizing the `createClient` factory method:
+
+```typescript
+import { createClient } from 'fastfetch-api-fetch-enhancer';
+
+// Instantiate your global HTTP client
+const api = createClient({
+  baseURL: 'https://api.example.com/v1',
+  headers: { 'Authorization': 'Bearer <token>' },
+  timeout: 10000,
+  retries: 3,
+  retryDelay: 1000,
+  maxConcurrent: 50,
+  circuitBreaker: {
+    threshold: 5,
+    timeout: 30000
+  }
+});
+
+// Koa-style middleware injection
+api.use(async (ctx, next) => {
+  ctx.init.headers['X-Request-Id'] = crypto.randomUUID();
+  await next();
+  console.log(`[HTTP ${ctx.response?.status}] ${ctx.method} ${ctx.url} - ${ctx.duration}ms`);
+});
+
+// Start making requests
+async function execute() {
+  try {
+    // Standard JSON shorthand
+    const user = await api.json('/users/me');
+    
+    // Auto-serialization for payload delivery
+    await api.post('/events', { action: 'login', timestamp: Date.now() });
+    
+  } catch (error) {
+    // Typed catch boundaries
+    if (error instanceof HttpError) {
+      console.error('API Rejected Request:', error.status);
+    } else if (error instanceof TimeoutError) {
+      console.error('Request timed out at:', error.timeout);
+    } else {
+      console.error('Catastrophic failure:', error);
     }
-};
+  }
+}
+```
+
+## Advanced Streaming (SSE)
+
+Consume AI generation pipelines directly over HTTP using the `stream` handler:
 
-fetchData();
+```typescript
+const signal = new AbortController();
+
+await api.stream(
+  '/ai/generate-text',
+  (event) => {
+    process.stdout.write(event.data);
+  },
+  { signal: signal.signal }
+);
 ```
 
-### Contribution
-We welcome contributions to FastFetch! If you have ideas for improvements, new features, or bug fixes, feel free to submit a pull request. Together we can make FastFetch even better for the community.
+## Monitoring & Telemetry
+
+Evaluate application stability at any time by accessing the built-in system telemetry map:
 
-### License
-FastFetch is licensed under the MIT License. See the [LICENSE](https://github.com/keshav-005/FastFetch-API-Fetch-Enhancer/releases) file for more details.
+```typescript
+const telemetry = api.metrics.snapshot();
+console.table(telemetry.byEndpoint);
+console.log('p99 global latency:', telemetry.globalLatencies.p99);
+```
 
----
+## License
 
-Thank you for choosing FastFetch as your API fetch enhancer. Make your API requests smarter, faster, and more reliable with FastFetch! 🌟🚀
+FastFetch is open-source software licensed under the MIT License.

package.json

@@ -21,12 +21,15 @@
   },
   "keywords": [
     "fetch",
-    "fastfetch",
+    "http-client",
+    "circuit-breaker",
+    "middleware",
+    "concurrency-queue",
+    "sse",
+    "telemetry",
+    "offline-queue",
     "retry",
-    "deduplication",
-    "http",
-    "api",
-    "typescript"
+    "axios-alternative"
   ],
   "repository": {
     "type": "git",