aziosxjs 1.0.0 → 1.0.2

package/README.md

@@ -1,176 +1,476 @@
 # Aziosxjs
 
-[![npm version](https://badge.fury.io/js/aziosxjs.svg)](https://badge.fury.io/js/aziosxjs) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/) [![Node.js](https://img.shields.io/badge/Node.js-14+-green.svg)](https://nodejs.org/)
+[![npm version](https://img.shields.io/npm/v/aziosxjs?style=flat-square)](https://www.npmjs.com/package/aziosxjs)
+[![npm downloads](https://img.shields.io/npm/dm/aziosxjs?style=flat-square)](https://www.npmjs.com/package/aziosxjs)
+[![npm downloads per week](https://img.shields.io/npm/dw/aziosxjs?style=flat-square)](https://www.npmjs.com/package/aziosxjs)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-14+-green.svg?style=flat-square)](https://nodejs.org/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](CONTRIBUTING.md)
 
-A lightweight, modular HTTP client with a clean API and a composable request pipeline.
+> 🚀 **Advanced HTTP client with request monitoring, built-in auth, plugins, middleware, and universal runtime support**
 
----
+**Aziosxjs** is a modern, lightweight, and highly extensible HTTP client for JavaScript/TypeScript applications. Built for production, featuring intelligent request monitoring, native authentication management, and a powerful plugin architecture.
 
-## Table of Contents
+---
 
-- [Installation](#installation)
-- [Quick Start](#quick-start)
-- [Core Concepts](#core-concepts)
-- [Plugins & Middleware](#plugins--middleware)
-- [Performance Features](#performance-features)
-- [Error Handling](#error-handling)
-- [Running Tests](#running-tests)
-- [Contributing](#contributing)
-- [License](#license)
+## 🌟 Why Aziosxjs?
+
+| Feature | Aziosxjs | Axios | Fetch |
+|---------|----------|-------|-------|
+| **Request Monitoring** | ✅ Built-in dashboard | ❌ 3rd party | ❌ No |
+| **Auth Manager** | ✅ Native + auto-refresh | ❌ Manual | ❌ No |
+| **Plugin System** | ✅ Full lifecycle | ❌ No | ❌ No |
+| **Middleware** | ✅ Koa-style | ❌ No | ❌ No |
+| **Interceptors** | ✅ Request/Response | ✅ Yes | ❌ No |
+| **Retry Logic** | ✅ Exponential backoff | ❌ No | ❌ No |
+| **Caching** | ✅ TTL-based | ❌ No | ❌ No |
+| **Rate Limiting** | ✅ Built-in | ❌ No | ❌ No |
+| **TypeScript** | ✅ Full support | ✅ Yes | ✅ Partial |
+| **Universal Runtime** | ✅ Node/Browser/Deno | ❌ Node/Browser | ✅ Universal |
 
 ---
 
-## Installation
+## 🚀 Quick Start
+
+### Installation
 
 ```bash
 npm install aziosxjs
 ```
 
----
+### Basic Usage
+
+```typescript
+import azios from 'aziosxjs'
+
+// GET request
+const user = await azios.get('https://api.example.com/users/1')
+console.log(user.data)
 
-## Quick Start
+// POST request
+const post = await azios.post('https://api.example.com/posts', {
+  title: 'Hello World',
+  body: 'My first post'
+})
 
-```js
-import azios from "aziosxjs";
+// PUT request
+await azios.put('https://api.example.com/posts/1', {
+  title: 'Updated Title'
+})
 
-const response = await azios.get("https://jsonplaceholder.typicode.com/users/1");
-console.log(response.data);
+// DELETE request
+await azios.delete('https://api.example.com/posts/1')
 ```
 
 ---
 
-## Core Concepts
+## ✨ Key Features
+
+### 1. 📊 Request Monitoring & Debug Dashboard
+
+Monitor all HTTP requests with real-time debugging:
+
+```typescript
+import azios from 'aziosxjs'
+
+// Enable monitoring
+azios.monitor.enable()
+
+// Make requests...
+await azios.get('https://api.example.com/users')
 
-### HTTP Methods
+// View request history
+console.log(azios.monitor.getHistory())
 
-```js
-await azios.get("/users");
-await azios.post("/users", { name: "Jane" });
-await azios.put("/users/1", { name: "Jane" });
-await azios.delete("/users/1");
+// Get statistics
+console.log(azios.monitor.getStats())
+// { totalRequests: 5, totalErrors: 1, averageDuration: 245, ... }
+
+// Export for analysis
+const json = azios.monitor.exportJSON()
+const csv = azios.monitor.exportCSV()
+
+// Filter and analyze
+const errors = azios.monitor.getErrors()
+const getRequests = azios.monitor.getByMethod('GET')
 ```
 
-### Configuration
+### 2. 🔐 Built-in Authentication Manager
 
-```js
-const response = await azios.request({
-  url: "/users",
-  method: "GET",
-  baseURL: "https://api.example.com",
-  params: { page: 1, limit: 10 },
-  headers: { Authorization: "Bearer TOKEN" },
-  timeout: 5000,
-});
+Enterprise-grade authentication with automatic token refresh:
+
+```typescript
+import azios, { createAuthPlugin } from 'aziosxjs'
+
+// Setup auth
+const authPlugin = createAuthPlugin({
+  refreshUrl: 'https://api.example.com/auth/refresh',
+  logoutUrl: 'https://api.example.com/auth/logout'
+})
+
+await azios.installPlugin(authPlugin)
+
+// Now all requests:
+// ✅ Attach Authorization headers
+// ✅ Detect 401 responses
+// ✅ Refresh token automatically
+// ✅ Retry with new token
 ```
 
-### Instances
+### 3. 🔌 Plugin System
 
-```js
-import { createInstance } from "aziosxjs";
+Extend functionality with a clean plugin architecture:
 
-const api = createInstance({ baseURL: "https://api.example.com" });
-await api.get("/users");
+```typescript
+import azios, { AziosPlugin } from 'aziosxjs'
+
+const loggingPlugin: AziosPlugin = {
+  name: 'logger',
+  version: '1.0.0',
+  hooks: {
+    beforeRequest: (config) => {
+      console.log(`📡 ${config.method} ${config.url}`)
+      return config
+    },
+    afterResponse: (response) => {
+      console.log(`✅ Status: ${response.status}`)
+      return response
+    }
+  }
+}
+
+await azios.installPlugin(loggingPlugin)
+```
+
+### 4. ⚙️ Middleware Pipeline
+
+Koa-style middleware for request processing:
+
+```typescript
+azios.use(async (ctx, next) => {
+  console.log('Before request')
+  await next()
+  console.log('After response')
+})
+```
+
+### 5. 🔄 Interceptors
+
+Intercept and transform requests/responses:
+
+```typescript
+azios.interceptors.request.use(
+  (config) => {
+    config.headers.Authorization = `Bearer ${token}`
+    return config
+  }
+)
+
+azios.interceptors.response.use(
+  (response) => response,
+  (error) => {
+    if (error.response?.status === 401) {
+      // Handle unauthorized
+    }
+    return Promise.reject(error)
+  }
+)
+```
+
+### 6. ⚡ Performance Features
+
+#### Retry with Exponential Backoff
+```typescript
+await azios.get('/api/data', {
+  retry: 3,         // Retry 3 times
+  retryDelay: 1000  // 1s, 2s, 4s delays
+})
+```
+
+#### Response Caching
+```typescript
+await azios.get('/api/users', {
+  cache: true,      // Enable caching
+  cacheTTL: 60000   // Cache for 60 seconds
+})
+```
+
+#### Rate Limiting
+```typescript
+await azios.post('/api/data', payload, {
+  rateLimit: 1000   // 1 request per second
+})
+```
+
+#### Request Deduplication
+```typescript
+// Both use the same network call
+const [data1, data2] = await Promise.all([
+  azios.get('/api/users/1'),
+  azios.get('/api/users/1')
+])
 ```
 
 ---
 
-## Plugins & Middleware
+## 📖 Complete Examples
 
-### Plugin System
+### Example 1: Simple GET/POST
 
-Plugins provide a clean way to extend Aziosxjs behavior.
+```typescript
+import azios from 'aziosxjs'
 
-```js
-import type { AziosPlugin } from "aziosxjs";
+async function main() {
+  const users = await azios.get('https://jsonplaceholder.typicode.com/users')
+  console.log(users.data)
 
-const authPlugin: AziosPlugin = {
-  name: "auth",
-  version: "1.0.0",
-  hooks: {
-    beforeRequest: (config) => ({
-      ...config,
-      headers: { ...config.headers, Authorization: "Bearer TOKEN" },
-    }),
-  },
-};
+  const post = await azios.post('https://jsonplaceholder.typicode.com/posts', {
+    title: 'My Post',
+    body: 'Content',
+    userId: 1
+  })
+  console.log(post.data)
+}
+```
+
+### Example 2: With Request Monitoring
 
-await azios.installPlugin(authPlugin);
+```typescript
+azios.monitor.enable()
+
+await azios.get('https://api.example.com/users')
+await azios.post('https://api.example.com/data', { /* data */ })
+
+console.log(azios.monitor.getSummary())
+console.log(azios.monitor.getStats())
 ```
 
-### Middleware
+### Example 3: With Authentication
+
+```typescript
+const authPlugin = createAuthPlugin({
+  refreshUrl: 'https://api.example.com/refresh',
+  logoutUrl: 'https://api.example.com/logout'
+})
+
+await azios.installPlugin(authPlugin)
+
+// Requests automatically handle auth and token refresh
+const data = await azios.get('https://api.example.com/protected')
+```
 
-Middleware runs in sequence and can modify the request/response pipeline.
+### Example 4: Custom Instances
 
-```js
-import type { AziosMiddleware } from "aziosxjs";
+```typescript
+import { createInstance } from 'aziosxjs'
 
-const logger: AziosMiddleware = async (config, next) => {
-  console.log("→", config.method, config.url);
-  const res = await next();
-  console.log("←", res.status);
-  return res;
-};
+const api = createInstance({
+  baseURL: 'https://api.example.com',
+  timeout: 10000,
+  headers: {
+    'X-Custom-Header': 'value'
+  }
+})
 
-azios.use(logger);
+const data = await api.get('/users')
+```
+
+### Example 5: Advanced Configuration
+
+```typescript
+const response = await azios.request({
+  url: '/api/users',
+  method: 'GET',
+  baseURL: 'https://api.example.com',
+  headers: { Authorization: 'Bearer token' },
+  params: { page: 1, limit: 10 },
+  timeout: 5000,
+  retry: 2,
+  retryDelay: 500,
+  cache: true,
+  cacheTTL: 30000,
+  rateLimit: 1000
+})
+```
+
+---
+
+## 🔧 Configuration
+
+### Request Config API
+
+```typescript
+interface AziosRequestConfig {
+  url?: string
+  method?: string
+  baseURL?: string
+  headers?: Record<string, any>
+  params?: Record<string, any>
+  data?: any
+  timeout?: number
+  responseType?: string
+  signal?: AbortSignal
+  retry?: number
+  retryDelay?: number
+  cache?: boolean
+  cacheTTL?: number
+  rateLimit?: number
+}
 ```
 
 ---
 
-## Performance Features
+## 📦 TypeScript Support
+
+Full TypeScript support with complete type safety:
 
-### Retry + Backoff
+```typescript
+import azios, { 
+  AziosInstance, 
+  AziosRequestConfig, 
+  AziosResponse,
+  RequestLog,
+  TokenConfig
+} from 'aziosxjs'
 
-```js
-await azios.get("/unstable", { retry: 3, retryDelay: 500 });
+const response: AziosResponse = await azios.get('/api/users')
 ```
 
-### Deduplication
+---
 
-Identical concurrent requests share the same network call.
+## 🌍 Universal Runtime Support
 
-### Caching
+Works across different JavaScript runtimes:
 
-```js
-await azios.get("/users", { cache: true, cacheTTL: 5000 });
+```typescript
+import { detectRuntime, currentRuntime } from 'aziosxjs'
+
+console.log(currentRuntime) // 'node' | 'browser' | 'deno' | 'bun'
 ```
 
-### Rate Limiting
+Supported: Node.js, Browser, Deno, Bun
+
+---
+
+## 🎯 API Reference
+
+### Monitoring API
+
+```typescript
+azios.monitor.enable()              // Enable tracking
+azios.monitor.disable()             // Disable tracking
+azios.monitor.getHistory()          // Get all logs
+azios.monitor.getStats()            // Get statistics
+azios.monitor.getErrors()           // Get failed requests
+azios.monitor.getByMethod(method)   // Filter by HTTP method
+azios.monitor.getByUrl(pattern)     // Filter by URL
+azios.monitor.exportJSON()          // Export as JSON
+azios.monitor.exportCSV()           // Export as CSV
+azios.monitor.getSummary()          // Get formatted summary
+azios.monitor.clear()               // Clear all logs
+```
 
-```js
-await azios.get("/users", { rateLimit: 5 });
+### Auth Manager API
+
+```typescript
+const auth = new AuthManager()
+
+auth.initialize(endpoints)          // Setup endpoints
+auth.setToken(token)                // Store token
+auth.getToken()                     // Get stored token
+auth.getAccessToken()               // Get access token string
+auth.hasToken()                     // Check if token exists
+auth.isTokenExpired()               // Check expiration
+auth.refreshAccessToken()           // Refresh token
+auth.attachAuthHeader(config)       // Add auth header
+auth.handle401(config)              // Handle 401 response
+auth.logout()                       // Logout and clear
+auth.getStatus()                    // Get auth status
 ```
 
 ---
 
-## Error Handling
+## 🛡️ Best Practices
 
-Aziosxjs throws `AziosError` instances with structured metadata.
+### Security
+
+```typescript
+// ✅ DO: Use secure token storage
+const authPlugin = createAuthPlugin({
+  refreshUrl: 'https://api.example.com/auth/refresh',
+  logoutUrl: 'https://api.example.com/auth/logout'
+})
+
+// ❌ DON'T: Store tokens in localStorage
+// localStorage.setItem('token', sensitiveToken)
+```
+
+### Error Handling
+
+```typescript
+import { AziosError } from 'aziosxjs'
 
-```js
 try {
-  await azios.get("/404");
-} catch (err) {
-  console.log(err.code, err.message);
+  await azios.get('/api/users')
+} catch (error) {
+  if (error instanceof AziosError) {
+    console.log(`[${error.response?.status}] ${error.message}`)
+  }
 }
 ```
 
+### Production Monitoring
+
+```typescript
+if (process.env.NODE_ENV === 'development') {
+  azios.monitor.enable()
+}
+
+setInterval(() => {
+  const stats = azios.monitor.getStats()
+  if (stats.totalErrors > 10) {
+    alerting.warn('High error rate!')
+  }
+}, 60000)
+```
+
 ---
 
-## Running Tests
+## 🧪 Testing
 
 ```bash
-npm test
+npm test                      # Run all tests
+npm run test:sprint8:monitoring  # Test monitoring
+npm run test:sprint8:auth        # Test auth
 ```
 
 ---
 
-## Contributing
+## 📚 Documentation
+
+- [Full Documentation](./docs/)
+- [Examples](./examples/)
+- [Changelog](./CHANGELOG.md)
+
+---
+
+## 🤝 Contributing
+
+Contributions welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md)
+
+---
+
+## 📄 License
 
-Contributions are welcome. Please open an issue or pull request.
+MIT © 2024 [Azeem Ali](https://github.com/azeemali2001)
 
 ---
 
-## License
+## 🙋 Support
 
-MIT © 2026 Azeem Ali
+- 📖 [Documentation](https://github.com/azeemali2001/azios)
+- 🐛 [Report Issues](https://github.com/azeemali2001/azios/issues)
+- 💬 [Discussions](https://github.com/azeemali2001/azios/discussions)
 
+**Made with ❤️ for the JavaScript community**

package/dist/adapters/httpAdapter.d.ts

@@ -0,0 +1,18 @@
+import type { AziosRequestConfig } from '../types/config';
+import type { AziosResponse } from '../types/response';
+import { BaseAdapter } from '../runtimes/HttpAdapter';
+/**
+ * Node.js HTTP adapter using built-in http/https modules
+ * Compatible with Node.js 16+ (before global fetch was available)
+ */
+export declare class NodeHttpAdapter extends BaseAdapter {
+    /**
+     * Check if this adapter is supported (Node.js environment)
+     */
+    isSupported(): boolean;
+    /**
+     * Execute HTTP request using Node.js http/https modules
+     */
+    request(config: AziosRequestConfig): Promise<AziosResponse>;
+}
+export default NodeHttpAdapter;