aziosxjs 0.4.0 → 1.0.0

package/dist/types/plugin.d.ts

@@ -0,0 +1,43 @@
+import { AziosRequestConfig } from './config';
+import { AziosResponse } from './response';
+import type { AziosInstance } from './request';
+/**
+ * Plugin lifecycle hooks
+ * Allows plugins to inject behavior at various stages of the request/response pipeline
+ */
+export interface PluginHooks {
+    /**
+     * Called when plugin is installed
+     */
+    onInstall?(instance: AziosInstance): void | Promise<void>;
+    /**
+     * Called before request is sent
+     */
+    beforeRequest?(config: AziosRequestConfig): AziosRequestConfig | Promise<AziosRequestConfig>;
+    /**
+     * Called after response is received
+     */
+    afterResponse?(response: AziosResponse): AziosResponse | Promise<AziosResponse>;
+    /**
+     * Called when an error occurs
+     */
+    onError?(error: Error): Error | Promise<Error>;
+    /**
+     * Called when plugin is uninstalled
+     */
+    onUninstall?(instance: AziosInstance): void | Promise<void>;
+}
+/**
+ * Plugin definition with metadata
+ */
+export interface AziosPlugin {
+    name: string;
+    version?: string;
+    hooks: PluginHooks;
+}
+/**
+ * Plugin registry to track installed plugins
+ */
+export interface PluginRegistry {
+    [key: string]: AziosPlugin;
+}

package/dist/types/plugin.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":""}

package/dist/types/request.d.ts

@@ -1,8 +1,23 @@
 import { AziosRequestConfig } from "./config";
 import { AziosResponse } from "./response";
+import InterceptorManager from "../interceptors/InterceptorManager";
+import type { AziosPlugin } from "./plugin";
+import type { AziosMiddleware } from "./middleware";
 export interface AziosInstance {
     (config: AziosRequestConfig): Promise<AziosResponse>;
     request(config: AziosRequestConfig): Promise<AziosResponse>;
     get(url: string, config?: AziosRequestConfig): Promise<AziosResponse>;
     post(url: string, data?: any, config?: AziosRequestConfig): Promise<AziosResponse>;
+    put(url: string, data?: any, config?: AziosRequestConfig): Promise<AziosResponse>;
+    patch(url: string, data?: any, config?: AziosRequestConfig): Promise<AziosResponse>;
+    delete(url: string, config?: AziosRequestConfig): Promise<AziosResponse>;
+    head(url: string, config?: AziosRequestConfig): Promise<AziosResponse>;
+    options(url: string, config?: AziosRequestConfig): Promise<AziosResponse>;
+    interceptors: {
+        request: InterceptorManager<AziosRequestConfig>;
+        response: InterceptorManager<AziosResponse>;
+    };
+    installPlugin(plugin: AziosPlugin): Promise<void>;
+    uninstallPlugin(name: string): Promise<void>;
+    use(middleware: AziosMiddleware): void;
 }

package/dist/types/response.d.ts

@@ -1,9 +1,31 @@
 import { AziosRequestConfig } from "./config";
+/**
+ * Azios HTTP response object
+ * Returned by all request methods
+ */
 export interface AziosResponse<T = any> {
+    /**
+     * Response data (parsed if JSON)
+     */
     data: T;
+    /**
+     * HTTP status code
+     */
     status: number;
+    /**
+     * HTTP status text
+     */
     statusText: string;
-    headers: any;
+    /**
+     * Response headers
+     */
+    headers: Record<string, any>;
+    /**
+     * Original request config
+     */
     config: AziosRequestConfig;
+    /**
+     * Native request object (if available)
+     */
     request?: any;
 }

package/package.json

@@ -1,21 +1,37 @@
 {
   "name": "aziosxjs",
-  "version": "0.4.0",
-  "description": "Lightweight HTTP client inspired by axios",
+  "version": "1.0.0",
+  "description": "Lightweight, predictable HTTP client with plugins, middleware, and universal runtime support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "test": "ts-node tests/all.test.ts",
+    "test:sprint1": "ts-node examples/sprint2.ts",
+    "test:sprint2": "ts-node examples/sprint2.ts",
+    "test:sprint3": "ts-node examples/sprint3.ts",
+    "test:sprint4": "ts-node examples/sprint4.ts",
+    "test:sprint5:plugins": "ts-node examples/sprint5-plugins.ts",
+    "test:sprint5:middleware": "ts-node examples/sprint5-middleware.ts",
+    "test:sprint7": "ts-node examples/sprint7-universal.ts",
+    "prepublishOnly": "npm run build"
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "keywords": [
     "http",
     "client",
     "axios",
     "request",
-    "nodejs"
+    "nodejs",
+    "browser",
+    "universal",
+    "plugin",
+    "middleware",
+    "lightweight",
+    "typescript"
   ],
   "author": "Azeem Ali",
   "license": "MIT",
@@ -26,5 +42,8 @@
   "homepage": "https://github.com/azeemali2001/azios",
   "bugs": {
     "url": "https://github.com/azeemali2001/azios/issues"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
   }
 }

package/src/cache/memoryCache.ts

@@ -0,0 +1,45 @@
+type CacheEntry = {
+  data: any
+  expiry: number
+}
+
+const cache = new Map<string, CacheEntry>()
+
+export function getCache(key: string) {
+
+  const entry = cache.get(key)
+
+  if (!entry) return null
+
+  // remove expired cache
+  if (Date.now() > entry.expiry) {
+    cache.delete(key)
+    return null
+  }
+
+  return entry.data
+
+}
+
+export function setCache(
+  key: string,
+  value: any,
+  ttl: number = 5000
+) {
+
+  const expiry = Date.now() + ttl
+
+  cache.set(key, {
+    data: value,
+    expiry
+  })
+
+}
+
+export function clearCache(key: string) {
+  cache.delete(key)
+}
+
+export function clearAllCache() {
+  cache.clear()
+}

package/src/core/Azios.ts

@@ -0,0 +1,184 @@
+import dispatchRequest from "./dispatchRequest"
+import { AziosRequestConfig } from "../types/config"
+import type { AziosInstance } from "../types/request"
+import type { AziosPlugin } from "../types/plugin"
+import InterceptorManager from "../interceptors/InterceptorManager"
+import PluginManager from "../plugins/pluginManager"
+import MiddlewareManager from "../middleware/middlewareManager"
+import { compose } from "../middleware/compose"
+
+/**
+ * Core Azios HTTP client class
+ * Production-grade implementation with plugin system, middleware, and interceptors
+ */
+export default class Azios {
+  defaults: AziosRequestConfig
+
+  interceptors: {
+    request: InterceptorManager<AziosRequestConfig>
+    response: InterceptorManager<any>
+  }
+
+  middlewares: MiddlewareManager
+  plugins: PluginManager
+
+  constructor(config: AziosRequestConfig) {
+    this.defaults = config
+
+    this.interceptors = {
+      request: new InterceptorManager(),
+      response: new InterceptorManager()
+    }
+
+    this.middlewares = new MiddlewareManager()
+    this.plugins = new PluginManager()
+  }
+
+  /**
+   * Register middleware using Koa-style middleware pattern
+   */
+  use(fn: any) {
+    this.middlewares.use(fn)
+  }
+
+  /**
+   * Install a plugin into this instance
+   * @throws Error if plugin is already installed or installation fails
+   */
+  async installPlugin(plugin: AziosPlugin): Promise<void> {
+    await this.plugins.install(plugin, this as any as AziosInstance)
+  }
+
+  /**
+   * Uninstall a plugin by name
+   */
+  async uninstallPlugin(pluginName: string): Promise<void> {
+    await this.plugins.uninstall(pluginName, this as any as AziosInstance)
+  }
+
+  /**
+   * Core request method - central request pipeline
+   */
+  async request(config: AziosRequestConfig): Promise<any> {
+    config = { ...this.defaults, ...config }
+
+    // -------------------------
+    // PLUGIN: PRE-REQUEST HOOKS
+    // -------------------------
+    config = await this.plugins.executeBeforeRequestHooks(config)
+
+    // -------------------------
+    // MIDDLEWARE PIPELINE
+    // -------------------------
+    const context = { config }
+    const fn = compose(this.middlewares.middlewares)
+    await fn(context)
+    config = context.config
+
+    // -------------------------
+    // INTERCEPTOR PIPELINE
+    // -------------------------
+    const chain: any[] = []
+
+    // Request interceptors (reverse order)
+    this.interceptors.request.forEach(interceptor => {
+      chain.unshift(interceptor.fulfilled, interceptor.rejected)
+    })
+
+    // Main dispatch
+    chain.push(dispatchRequest, undefined)
+
+    // Response interceptors (normal order)
+    this.interceptors.response.forEach(interceptor => {
+      chain.push(interceptor.fulfilled, interceptor.rejected)
+    })
+
+    let promise = Promise.resolve(config)
+
+    while (chain.length) {
+      const fulfilled = chain.shift()
+      const rejected = chain.shift()
+      promise = promise.then(fulfilled, rejected)
+    }
+
+    try {
+      const response = await promise as any
+
+      // -------------------------
+      // PLUGIN: POST-RESPONSE HOOKS
+      // -------------------------
+      return await this.plugins.executeAfterResponseHooks(response)
+    } catch (error) {
+      // -------------------------
+      // PLUGIN: ERROR HOOKS
+      // -------------------------
+      if (error instanceof Error) {
+        throw await this.plugins.executeOnErrorHooks(error)
+      }
+      throw error
+    }
+  }
+
+  // =========================================
+  // HTTP METHODS
+  // =========================================
+
+  get(url: string, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "GET",
+      url
+    })
+  }
+
+  post(url: string, data?: any, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "POST",
+      url,
+      data
+    })
+  }
+
+  put(url: string, data?: any, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "PUT",
+      url,
+      data
+    })
+  }
+
+  patch(url: string, data?: any, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "PATCH",
+      url,
+      data
+    })
+  }
+
+  delete(url: string, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "DELETE",
+      url
+    })
+  }
+
+  head(url: string, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "HEAD",
+      url
+    })
+  }
+
+  options(url: string, config?: AziosRequestConfig) {
+    return this.request({
+      ...config,
+      method: "OPTIONS",
+      url
+    })
+  }
+}

package/src/core/createInstance.ts

@@ -0,0 +1,23 @@
+import Azios from "./Azios"
+import { AziosRequestConfig } from "../types/config"
+import { AziosInstance } from "../types/request"
+
+export function createInstance(config: AziosRequestConfig): AziosInstance {
+
+  const context = new Azios(config)
+
+  const instance = Azios.prototype.request.bind(context) as AziosInstance
+
+  Object.getOwnPropertyNames(Azios.prototype).forEach(method => {
+
+    if (method !== "constructor") {
+      ;(instance as any)[method] = (Azios.prototype as any)[method].bind(context)
+    }
+
+  })
+
+  // attach interceptors
+  instance.interceptors = context.interceptors
+
+  return instance
+}

package/src/core/dispatchRequest.ts

@@ -0,0 +1,111 @@
+import { AziosRequestConfig } from "../types/config"
+import { AziosResponse } from "../types/response"
+import buildURL from "../helpers/buildURL"
+import AziosError from "../errors/AziosError"
+import AdapterFactory from "../runtimes/AdapterFactory"
+
+import { getPending, setPending, removePending } from "./requestStore"
+import { getCache, setCache } from "../cache/memoryCache"
+import { schedule } from "../rateLimiter/rateLimiter"
+
+/**
+ * Sleep utility for retry delays
+ */
+function delay(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+/**
+ * Make a single HTTP request using the universal adapter
+ * This ensures cross-runtime compatibility
+ */
+async function makeRequest(config: AziosRequestConfig): Promise<AziosResponse> {
+  const adapter = AdapterFactory.getAdapter()
+  return adapter.request(config)
+}
+
+export default async function dispatchRequest(config: AziosRequestConfig) {
+
+  const requestKey =
+    `${config.method}-${config.url}-${JSON.stringify(config.params)}`
+
+  // -------------------------
+  // CACHE CHECK (Sprint 4)
+  // -------------------------
+
+  if (config.cache) {
+
+    const cached = getCache(requestKey)
+
+    if (cached) {
+      return cached
+    }
+
+  }
+
+  // -------------------------
+  // DEDUPLICATION (Sprint 3)
+  // -------------------------
+
+  const existing = getPending(requestKey)
+
+  if (existing) {
+    return existing
+  }
+
+  const retries = config.retry || 0
+  const retryDelay = config.retryDelay || 300
+
+  let attempt = 0
+
+  const promise = (async () => {
+
+    while (true) {
+
+      try {
+
+        const task = () => makeRequest(config)
+
+        const response = config.rateLimit
+          ? await schedule(task, config.rateLimit)
+          : await task()
+
+        // -------------------------
+        // CACHE STORE
+        // -------------------------
+
+        if (config.cache) {
+          setCache(requestKey, response, config.cacheTTL ?? 5000)
+        }
+
+        removePending(requestKey)
+
+        return response
+
+      } catch (err) {
+
+        if (attempt >= retries) {
+
+          removePending(requestKey)
+
+          throw err
+
+        }
+
+        attempt++
+
+        const backoff = retryDelay * Math.pow(2, attempt)
+
+        await delay(backoff)
+
+      }
+
+    }
+
+  })()
+
+  setPending(requestKey, promise)
+
+  return promise
+
+}

package/src/core/requestStore.ts

@@ -0,0 +1,13 @@
+const pendingRequests = new Map()
+
+export function getPending(key: string) {
+  return pendingRequests.get(key)
+}
+
+export function setPending(key: string, promise: Promise<any>) {
+  pendingRequests.set(key, promise)
+}
+
+export function removePending(key: string) {
+  pendingRequests.delete(key)
+}

package/src/errors/AziosError.ts

@@ -0,0 +1,26 @@
+export default class AziosError extends Error {
+
+  config: any
+  code?: string
+  request?: any
+  response?: any
+
+  constructor(
+    message: string,
+    code?: string,
+    config?: any,
+    request?: any,
+    response?: any
+  ) {
+
+    super(message)
+
+    this.name = "AziosError"
+    this.code = code
+    this.config = config
+    this.request = request
+    this.response = response
+
+  }
+
+}

package/src/helpers/buildURL.ts

@@ -0,0 +1,44 @@
+export default function buildURL(
+  url: string,
+  params?: Record<string, any>
+) {
+
+  if (!params) return url
+
+  const parts: string[] = []
+
+  Object.keys(params).forEach(key => {
+
+    const val = params[key]
+
+    if (val === null || typeof val === "undefined") {
+      return
+    }
+
+    if (Array.isArray(val)) {
+
+      val.forEach(v => {
+        parts.push(
+          `${encodeURIComponent(key)}=${encodeURIComponent(v)}`
+        )
+      })
+
+    } else {
+
+      parts.push(
+        `${encodeURIComponent(key)}=${encodeURIComponent(val)}`
+      )
+
+    }
+
+  })
+
+  if (parts.length === 0) return url
+
+  const serialized = parts.join("&")
+
+  return url.includes("?")
+    ? `${url}&${serialized}`
+    : `${url}?${serialized}`
+
+}

package/src/index.ts

@@ -0,0 +1,64 @@
+import { createInstance } from "./core/createInstance"
+
+// Export main instance
+const azios = createInstance({
+  url: ""
+})
+
+// ============================================
+// Type Exports
+// ============================================
+
+export type { AziosRequestConfig } from "./types/config"
+export type { AziosResponse } from "./types/response"
+export type { AziosInstance } from "./types/request"
+export type { AziosPlugin, PluginHooks } from "./types/plugin"
+
+// ============================================
+// Class Exports
+// ============================================
+
+export { default as AziosError } from "./errors/AziosError"
+export { default as InterceptorManager } from "./interceptors/InterceptorManager"
+export { default as Azios } from "./core/Azios"
+export { createInstance } from "./core/createInstance"
+
+// ============================================
+// Plugin System Exports
+// ============================================
+
+export { default as PluginManager } from "./plugins/pluginManager"
+
+// ============================================
+// Middleware System Exports
+// ============================================
+
+export { default as MiddlewarePipeline } from "./middleware/MiddlewarePipeline"
+export type { RequestMiddleware, ResponseMiddleware } from "./middleware/MiddlewarePipeline"
+
+// ============================================
+// Runtime Support Exports
+// ============================================
+
+export {
+  detectRuntime,
+  currentRuntime,
+  isRuntime,
+  isServerRuntime,
+  isBrowserRuntime,
+  RuntimeType
+} from "./runtimes/detectRuntime"
+export { default as AdapterFactory } from "./runtimes/AdapterFactory"
+
+// ============================================
+// Cache & Rate Limit Exports
+// ============================================
+
+export { getCache, setCache, clearCache } from "./cache/memoryCache"
+export { schedule } from "./rateLimiter/rateLimiter"
+
+// ============================================
+// Default Export
+// ============================================
+
+export default azios