axios-engine 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 yunush
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,280 @@
+# @yunush/api-engine
+
+A platform-agnostic networking library built on [Axios](https://axios-http.com), designed to work seamlessly across **React Native**, **React (Web)**, **Next.js**, and **Node.js**.
+
+[![npm version](https://img.shields.io/npm/v/@yunush/api-engine.svg)](https://www.npmjs.com/package/@yunush/api-engine)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+---
+
+## Features
+
+- 🔐 **Token injection** — automatically attaches Bearer tokens to every request
+- ♻️ **Token refresh** — handles 401 responses, retries the original request, and queues concurrent calls during refresh
+- 🔁 **Retry logic** — configurable retry attempts for network failures
+- ⏱️ **Response delay** — runtime-toggleable delays for testing loading states
+- 🖥️ **Backend-controlled delay** — honour `X-API-Delay` response headers from your server
+- 🪵 **Structured logging** — request/response logs with timing, opt-in per environment
+- 🎯 **Normalised errors** — every error follows `{ status, message, data }` regardless of source
+- 🧩 **Fully typed** — complete TypeScript definitions included
+
+---
+
+## Installation
+
+```bash
+npm install @yunush/api-engine axios
+# or
+yarn add @yunush/api-engine axios
+```
+
+> `axios` is a peer dependency and must be installed alongside the library.
+
+---
+
+## Quick Start
+
+```ts
+import { createApiEngine } from "@yunush/api-engine";
+
+export const api = createApiEngine({
+  baseURL: "https://api.myapp.com",
+});
+
+// Use it anywhere
+const users = await api.get("/users");
+const created = await api.post("/users", { name: "Alice" });
+```
+
+---
+
+## Configuration
+
+```ts
+createApiEngine({
+  baseURL: "https://api.myapp.com",
+
+  // Return the current auth token (sync or async)
+  getToken: async () => AsyncStorage.getItem("token"),
+
+  // Called on 401 — return a fresh token
+  refreshToken: async () => {
+    const res = await fetch("/auth/refresh");
+    const { token } = await res.json();
+    return token;
+  },
+
+  // Called when refresh fails
+  onLogout: () => router.push("/login"),
+
+  // Retry network failures up to N times
+  retry: 2,
+
+  // Static delay applied to every response (ms)
+  responseDelay: 0,
+
+  // Log requests and responses
+  enableLogging: true,
+
+  // Any extra Axios defaults
+  axiosConfig: { timeout: 15_000 },
+});
+```
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `baseURL` | `string` | — | Base URL for all requests |
+| `getToken` | `() => string \| null` | — | Returns the current auth token |
+| `refreshToken` | `() => Promise<string>` | — | Fetches a new token on 401 |
+| `onLogout` | `() => void` | — | Called when refresh fails |
+| `retry` | `number` | `0` | Network error retry count |
+| `responseDelay` | `number` | `0` | Static delay in ms |
+| `enableLogging` | `boolean` | `false` | Enable console logging |
+| `axiosConfig` | `AxiosRequestConfig` | `{}` | Extra Axios options |
+
+---
+
+## Response Delay
+
+Useful for testing loading states, simulating slow networks, and demos.
+
+```ts
+import { setResponseDelay } from "@yunush/api-engine";
+
+// Enable a 5-second delay globally
+setResponseDelay(true, 5000);
+
+// Disable it
+setResponseDelay(false);
+```
+
+### Backend-Controlled Delay
+
+Your backend can control delay without a client deploy by setting the `X-API-Delay` header:
+
+```js
+// Express example
+app.get("/users", (req, res) => {
+  res.set("X-API-Delay", "3000");  // 3-second delay
+  res.json({ users: [] });
+});
+```
+
+### Admin Config Pattern
+
+```ts
+const config = await api.get<{ apiDelayEnabled: boolean; apiDelayTime: number }>("/app-config");
+setResponseDelay(config.apiDelayEnabled, config.apiDelayTime);
+```
+
+This lets admins toggle API throttling at runtime without redeploying your app.
+
+---
+
+## Platform Examples
+
+### React Native (AsyncStorage)
+
+```ts
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { createApiEngine } from "@yunush/api-engine";
+
+export const api = createApiEngine({
+  baseURL: "https://api.myapp.com",
+  getToken: () => AsyncStorage.getItem("token"),
+  refreshToken: async () => {
+    const res = await fetch("https://api.myapp.com/auth/refresh");
+    const { token } = await res.json();
+    await AsyncStorage.setItem("token", token);
+    return token;
+  },
+  onLogout: () => {
+    AsyncStorage.removeItem("token");
+    // navigate to login screen
+  },
+  retry: 2,
+  enableLogging: __DEV__,
+});
+```
+
+### React / Next.js (localStorage)
+
+```ts
+import { createApiEngine } from "@yunush/api-engine";
+
+export const api = createApiEngine({
+  baseURL: process.env.NEXT_PUBLIC_API_URL!,
+  getToken: () => localStorage.getItem("token"),
+  refreshToken: async () => {
+    const res = await fetch("/api/auth/refresh");
+    const { token } = await res.json();
+    localStorage.setItem("token", token);
+    return token;
+  },
+  onLogout: () => {
+    localStorage.removeItem("token");
+    window.location.href = "/login";
+  },
+  enableLogging: process.env.NODE_ENV === "development",
+});
+```
+
+### Node.js
+
+```ts
+import { createApiEngine } from "@yunush/api-engine";
+
+const api = createApiEngine({
+  baseURL: "https://api.partner.com",
+  getToken: () => process.env.API_TOKEN ?? null,
+  retry: 3,
+  enableLogging: true,
+});
+```
+
+---
+
+## Error Handling
+
+All errors are normalised into `ApiError` — a typed subclass of `Error`:
+
+```ts
+import { ApiError } from "@yunush/api-engine";
+
+try {
+  const data = await api.get("/users");
+} catch (err) {
+  if (err instanceof ApiError) {
+    console.log(err.status);   // e.g. 404
+    console.log(err.message);  // e.g. "Not Found"
+    console.log(err.data);     // response body (if any)
+  }
+}
+```
+
+| Field | Type | Description |
+|---|---|---|
+| `status` | `number` | HTTP status code (`0` = network error, `-1` = unknown) |
+| `message` | `string` | Human-readable error message |
+| `data` | `unknown` | Raw response body from the server |
+
+---
+
+## Token Refresh Flow
+
+```
+Request → 401 response
+    ↓
+Call refreshToken()
+    ↓
+Success?
+  Yes → update Authorization header → retry original request
+  No  → call onLogout() → throw ApiError
+```
+
+Concurrent requests that arrive while a refresh is in-flight are queued and replayed automatically once the new token is available.
+
+---
+
+## Logging
+
+When `enableLogging: true`:
+
+```
+[API Engine] → GET /users
+[API Engine] ← GET /users [200] 142ms
+[API Engine] Token expired — refreshing...
+[API Engine] ← GET /users [200] 98ms
+```
+
+Disable in production:
+
+```ts
+enableLogging: process.env.NODE_ENV !== "production"
+```
+
+---
+
+## Best Practices
+
+**Create a single shared instance**
+```ts
+// lib/api.ts
+export const api = createApiEngine({ ... });
+```
+
+**Fetch backend config on app startup**
+```ts
+// app entry point
+const config = await api.get("/app-config");
+setResponseDelay(config.delayEnabled, config.delayMs);
+```
+
+**Don't create multiple instances** — multiple interceptor stacks lead to unpredictable behaviour.
+
+---
+
+## License
+
+MIT © yunush

package/dist/createApiEngine.d.ts

@@ -0,0 +1,2 @@
+import { ApiEngine, ApiEngineConfig } from "./types";
+export declare function createApiEngine(config: ApiEngineConfig): ApiEngine;

package/dist/delayManager.d.ts

@@ -0,0 +1,19 @@
+import { DelayState } from "./types";
+/**
+ * Enable or disable global response delay.
+ *
+ * @param enabled - Whether delay should be active
+ * @param duration - Delay duration in milliseconds (required when enabling)
+ *
+ * @example
+ * // Enable a 3-second delay
+ * setResponseDelay(true, 3000);
+ *
+ * // Disable delay
+ * setResponseDelay(false);
+ */
+export declare function setResponseDelay(enabled: boolean, duration?: number): void;
+/** Get current delay state (used internally by interceptors) */
+export declare function getDelayState(): Readonly<DelayState>;
+/** Returns a Promise that resolves after the current delay duration */
+export declare function applyDelay(overrideDuration?: number): Promise<void>;

package/dist/errorNormalizer.d.ts

@@ -0,0 +1,14 @@
+import { NormalizedError } from "./types";
+/**
+ * Normalizes any error thrown by Axios into a consistent shape.
+ *
+ * All API errors conform to:
+ * { status: number, message: string, data: unknown }
+ */
+export declare function normalizeError(error: unknown): NormalizedError;
+/** Creates a typed error object from a normalized error */
+export declare class ApiError extends Error implements NormalizedError {
+    status: number;
+    data: unknown;
+    constructor(normalized: NormalizedError);
+}

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import * as axios from 'axios';
+import { AxiosRequestConfig } from 'axios';
+
+interface ApiEngineConfig {
+    /** Base URL for all API requests */
+    baseURL: string;
+    /** Async function that returns the current auth token */
+    getToken?: () => Promise<string | null> | string | null;
+    /** Called when a 401 is received; should return a new token */
+    refreshToken?: () => Promise<string | null>;
+    /** Called when token refresh fails — use to redirect to login */
+    onLogout?: () => void;
+    /** Number of retry attempts on network failures (default: 0) */
+    retry?: number;
+    /** Static delay in ms applied to every response (default: 0) */
+    responseDelay?: number;
+    /** Enable request/response logging (default: false) */
+    enableLogging?: boolean;
+    /** Additional Axios config defaults */
+    axiosConfig?: AxiosRequestConfig;
+}
+interface NormalizedError {
+    status: number;
+    message: string;
+    data: unknown;
+}
+interface DelayState {
+    enabled: boolean;
+    duration: number;
+}
+interface ApiEngine {
+    get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    request<T = unknown>(config: AxiosRequestConfig): Promise<T>;
+    getAxiosInstance(): axios.AxiosInstance;
+}
+
+declare function createApiEngine(config: ApiEngineConfig): ApiEngine;
+
+/**
+ * Enable or disable global response delay.
+ *
+ * @param enabled - Whether delay should be active
+ * @param duration - Delay duration in milliseconds (required when enabling)
+ *
+ * @example
+ * // Enable a 3-second delay
+ * setResponseDelay(true, 3000);
+ *
+ * // Disable delay
+ * setResponseDelay(false);
+ */
+declare function setResponseDelay(enabled: boolean, duration?: number): void;
+/** Get current delay state (used internally by interceptors) */
+declare function getDelayState(): Readonly<DelayState>;
+
+/** Creates a typed error object from a normalized error */
+declare class ApiError extends Error implements NormalizedError {
+    status: number;
+    data: unknown;
+    constructor(normalized: NormalizedError);
+}
+
+export { ApiError, createApiEngine, getDelayState, setResponseDelay };
+export type { ApiEngine, ApiEngineConfig, DelayState, NormalizedError };

package/dist/index.esm.js

@@ -0,0 +1,255 @@
+import axios, { AxiosError } from 'axios';
+
+/** Internal singleton state for response delay */
+const delayState = {
+    enabled: false,
+    duration: 0,
+};
+/**
+ * Enable or disable global response delay.
+ *
+ * @param enabled - Whether delay should be active
+ * @param duration - Delay duration in milliseconds (required when enabling)
+ *
+ * @example
+ * // Enable a 3-second delay
+ * setResponseDelay(true, 3000);
+ *
+ * // Disable delay
+ * setResponseDelay(false);
+ */
+function setResponseDelay(enabled, duration = 0) {
+    delayState.enabled = enabled;
+    delayState.duration = enabled ? duration : 0;
+}
+/** Get current delay state (used internally by interceptors) */
+function getDelayState() {
+    return delayState;
+}
+/** Returns a Promise that resolves after the current delay duration */
+function applyDelay(overrideDuration) {
+    const duration = overrideDuration !== null && overrideDuration !== void 0 ? overrideDuration : delayState.duration;
+    if (!delayState.enabled && overrideDuration === undefined)
+        return Promise.resolve();
+    if (duration <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, duration));
+}
+
+let loggingEnabled = false;
+function setLogging(enabled) {
+    loggingEnabled = enabled;
+}
+function log(level, ...args) {
+    if (!loggingEnabled)
+        return;
+    const prefix = "[API Engine]";
+    switch (level) {
+        case "info":
+            console.log(prefix, ...args);
+            break;
+        case "warn":
+            console.warn(prefix, ...args);
+            break;
+        case "error":
+            console.error(prefix, ...args);
+            break;
+    }
+}
+const logger = {
+    info: (...args) => log("info", ...args),
+    warn: (...args) => log("warn", ...args),
+    error: (...args) => log("error", ...args),
+    request: (method, url) => log("info", `→ ${method.toUpperCase()} ${url}`),
+    response: (method, url, status, durationMs) => log("info", `← ${method.toUpperCase()} ${url} [${status}] ${durationMs}ms`),
+    retrying: (attempt, max, url) => log("warn", `Retrying (${attempt}/${max}): ${url}`),
+    tokenRefresh: () => log("info", "Token expired — refreshing..."),
+    logout: () => log("warn", "Token refresh failed — logging out."),
+};
+
+/**
+ * Normalizes any error thrown by Axios into a consistent shape.
+ *
+ * All API errors conform to:
+ * { status: number, message: string, data: unknown }
+ */
+function normalizeError(error) {
+    var _a, _b, _c;
+    if (error instanceof AxiosError) {
+        const response = error.response;
+        if (response) {
+            const data = response.data;
+            return {
+                status: response.status,
+                message: (_c = (_b = (_a = (data && typeof data.message === "string" ? data.message : null)) !== null && _a !== void 0 ? _a : error.message) !== null && _b !== void 0 ? _b : response.statusText) !== null && _c !== void 0 ? _c : "Unknown error",
+                data: data !== null && data !== void 0 ? data : {},
+            };
+        }
+        // Network error / timeout — no response received
+        if (error.request) {
+            return {
+                status: 0,
+                message: error.code === "ECONNABORTED" ? "Request timed out" : "Network error — no response received",
+                data: {},
+            };
+        }
+    }
+    // Non-Axios error
+    if (error instanceof Error) {
+        return { status: -1, message: error.message, data: {} };
+    }
+    return { status: -1, message: "An unexpected error occurred", data: {} };
+}
+/** Creates a typed error object from a normalized error */
+class ApiError extends Error {
+    constructor(normalized) {
+        super(normalized.message);
+        this.name = "ApiError";
+        this.status = normalized.status;
+        this.data = normalized.data;
+    }
+}
+
+const RETRY_COUNT_KEY = "__retryCount";
+const START_TIME_KEY = "__startTime";
+function createApiEngine(config) {
+    const { baseURL, getToken, refreshToken, onLogout, retry = 0, responseDelay = 0, enableLogging = false, axiosConfig = {}, } = config;
+    // Apply initial static delay if provided in config
+    if (responseDelay > 0) {
+        const { setResponseDelay } = require("./delayManager");
+        setResponseDelay(true, responseDelay);
+    }
+    setLogging(enableLogging);
+    const instance = axios.create(Object.assign({ baseURL, timeout: 30000, headers: { "Content-Type": "application/json" } }, axiosConfig));
+    let isRefreshing = false;
+    let refreshQueue = [];
+    function processRefreshQueue(token, error) {
+        for (const pending of refreshQueue) {
+            if (token) {
+                pending.resolve(token);
+            }
+            else {
+                pending.reject(error);
+            }
+        }
+        refreshQueue = [];
+    }
+    // ─── Request Interceptor ─────────────────────────────────────────────────
+    instance.interceptors.request.use(async (req) => {
+        var _a, _b, _c;
+        // Stamp start time for logging
+        req[START_TIME_KEY] = Date.now();
+        // Inject auth token
+        if (getToken) {
+            const token = await getToken();
+            if (token) {
+                req.headers = (_a = req.headers) !== null && _a !== void 0 ? _a : {};
+                req.headers["Authorization"] = `Bearer ${token}`;
+            }
+        }
+        logger.request((_b = req.method) !== null && _b !== void 0 ? _b : "GET", (_c = req.url) !== null && _c !== void 0 ? _c : "");
+        return req;
+    }, (error) => Promise.reject(error));
+    // ─── Response Interceptor ────────────────────────────────────────────────
+    instance.interceptors.response.use(async (response) => {
+        var _a, _b;
+        const req = response.config;
+        const start = req[START_TIME_KEY];
+        const duration = start ? Date.now() - start : 0;
+        logger.response((_a = response.config.method) !== null && _a !== void 0 ? _a : "GET", (_b = response.config.url) !== null && _b !== void 0 ? _b : "", response.status, duration);
+        // ── Backend-controlled delay via X-API-Delay header ──
+        const headerDelay = response.headers["x-api-delay"];
+        if (headerDelay) {
+            const ms = parseInt(headerDelay, 10);
+            if (!isNaN(ms) && ms > 0) {
+                logger.info(`Applying backend-controlled delay: ${ms}ms`);
+                await applyDelay(ms);
+            }
+        }
+        // ── Global runtime delay ──
+        else {
+            const delayState = getDelayState();
+            if (delayState.enabled && delayState.duration > 0) {
+                await applyDelay(delayState.duration);
+            }
+        }
+        return response;
+    }, async (error) => {
+        var _a, _b, _c;
+        const originalRequest = error.config;
+        if (!originalRequest) {
+            throw new ApiError(normalizeError(error));
+        }
+        // ── Retry logic for network failures ──
+        const isNetworkError = !error.response && error.request;
+        const currentRetry = (_a = originalRequest[RETRY_COUNT_KEY]) !== null && _a !== void 0 ? _a : 0;
+        if (isNetworkError && currentRetry < retry) {
+            originalRequest[RETRY_COUNT_KEY] = currentRetry + 1;
+            logger.retrying(currentRetry + 1, retry, (_b = originalRequest.url) !== null && _b !== void 0 ? _b : "");
+            return instance(originalRequest);
+        }
+        // ── 401 Token Refresh ──
+        if (((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) === 401 && refreshToken && !originalRequest["__isRetry"]) {
+            originalRequest["__isRetry"] = true;
+            if (isRefreshing) {
+                // Queue this request until refresh completes
+                return new Promise((resolve, reject) => {
+                    refreshQueue.push({
+                        resolve: (newToken) => {
+                            originalRequest.headers["Authorization"] = `Bearer ${newToken}`;
+                            resolve(instance(originalRequest));
+                        },
+                        reject,
+                    });
+                });
+            }
+            isRefreshing = true;
+            logger.tokenRefresh();
+            try {
+                const newToken = await refreshToken();
+                isRefreshing = false;
+                if (!newToken)
+                    throw new Error("Refresh returned empty token");
+                processRefreshQueue(newToken, null);
+                originalRequest.headers["Authorization"] = `Bearer ${newToken}`;
+                return instance(originalRequest);
+            }
+            catch (refreshError) {
+                isRefreshing = false;
+                processRefreshQueue(null, refreshError);
+                logger.logout();
+                onLogout === null || onLogout === void 0 ? void 0 : onLogout();
+                throw new ApiError(normalizeError(error));
+            }
+        }
+        // ── Normalize all other errors ──
+        throw new ApiError(normalizeError(error));
+    });
+    // ─── Public API ──────────────────────────────────────────────────────────
+    return {
+        get(url, config) {
+            return instance.get(url, config);
+        },
+        post(url, data, config) {
+            return instance.post(url, data, config);
+        },
+        put(url, data, config) {
+            return instance.put(url, data, config);
+        },
+        patch(url, data, config) {
+            return instance.patch(url, data, config);
+        },
+        delete(url, config) {
+            return instance.delete(url, config);
+        },
+        request(config) {
+            return instance.request(config);
+        },
+        getAxiosInstance() {
+            return instance;
+        },
+    };
+}
+
+export { ApiError, createApiEngine, getDelayState, setResponseDelay };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/delayManager.ts","../src/logger.ts","../src/errorNormalizer.ts","../src/createApiEngine.ts"],"sourcesContent":[null,null,null,null],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,260 @@
+'use strict';
+
+var axios = require('axios');
+
+/** Internal singleton state for response delay */
+const delayState = {
+    enabled: false,
+    duration: 0,
+};
+/**
+ * Enable or disable global response delay.
+ *
+ * @param enabled - Whether delay should be active
+ * @param duration - Delay duration in milliseconds (required when enabling)
+ *
+ * @example
+ * // Enable a 3-second delay
+ * setResponseDelay(true, 3000);
+ *
+ * // Disable delay
+ * setResponseDelay(false);
+ */
+function setResponseDelay(enabled, duration = 0) {
+    delayState.enabled = enabled;
+    delayState.duration = enabled ? duration : 0;
+}
+/** Get current delay state (used internally by interceptors) */
+function getDelayState() {
+    return delayState;
+}
+/** Returns a Promise that resolves after the current delay duration */
+function applyDelay(overrideDuration) {
+    const duration = overrideDuration !== null && overrideDuration !== void 0 ? overrideDuration : delayState.duration;
+    if (!delayState.enabled && overrideDuration === undefined)
+        return Promise.resolve();
+    if (duration <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, duration));
+}
+
+let loggingEnabled = false;
+function setLogging(enabled) {
+    loggingEnabled = enabled;
+}
+function log(level, ...args) {
+    if (!loggingEnabled)
+        return;
+    const prefix = "[API Engine]";
+    switch (level) {
+        case "info":
+            console.log(prefix, ...args);
+            break;
+        case "warn":
+            console.warn(prefix, ...args);
+            break;
+        case "error":
+            console.error(prefix, ...args);
+            break;
+    }
+}
+const logger = {
+    info: (...args) => log("info", ...args),
+    warn: (...args) => log("warn", ...args),
+    error: (...args) => log("error", ...args),
+    request: (method, url) => log("info", `→ ${method.toUpperCase()} ${url}`),
+    response: (method, url, status, durationMs) => log("info", `← ${method.toUpperCase()} ${url} [${status}] ${durationMs}ms`),
+    retrying: (attempt, max, url) => log("warn", `Retrying (${attempt}/${max}): ${url}`),
+    tokenRefresh: () => log("info", "Token expired — refreshing..."),
+    logout: () => log("warn", "Token refresh failed — logging out."),
+};
+
+/**
+ * Normalizes any error thrown by Axios into a consistent shape.
+ *
+ * All API errors conform to:
+ * { status: number, message: string, data: unknown }
+ */
+function normalizeError(error) {
+    var _a, _b, _c;
+    if (error instanceof axios.AxiosError) {
+        const response = error.response;
+        if (response) {
+            const data = response.data;
+            return {
+                status: response.status,
+                message: (_c = (_b = (_a = (data && typeof data.message === "string" ? data.message : null)) !== null && _a !== void 0 ? _a : error.message) !== null && _b !== void 0 ? _b : response.statusText) !== null && _c !== void 0 ? _c : "Unknown error",
+                data: data !== null && data !== void 0 ? data : {},
+            };
+        }
+        // Network error / timeout — no response received
+        if (error.request) {
+            return {
+                status: 0,
+                message: error.code === "ECONNABORTED" ? "Request timed out" : "Network error — no response received",
+                data: {},
+            };
+        }
+    }
+    // Non-Axios error
+    if (error instanceof Error) {
+        return { status: -1, message: error.message, data: {} };
+    }
+    return { status: -1, message: "An unexpected error occurred", data: {} };
+}
+/** Creates a typed error object from a normalized error */
+class ApiError extends Error {
+    constructor(normalized) {
+        super(normalized.message);
+        this.name = "ApiError";
+        this.status = normalized.status;
+        this.data = normalized.data;
+    }
+}
+
+const RETRY_COUNT_KEY = "__retryCount";
+const START_TIME_KEY = "__startTime";
+function createApiEngine(config) {
+    const { baseURL, getToken, refreshToken, onLogout, retry = 0, responseDelay = 0, enableLogging = false, axiosConfig = {}, } = config;
+    // Apply initial static delay if provided in config
+    if (responseDelay > 0) {
+        const { setResponseDelay } = require("./delayManager");
+        setResponseDelay(true, responseDelay);
+    }
+    setLogging(enableLogging);
+    const instance = axios.create(Object.assign({ baseURL, timeout: 30000, headers: { "Content-Type": "application/json" } }, axiosConfig));
+    let isRefreshing = false;
+    let refreshQueue = [];
+    function processRefreshQueue(token, error) {
+        for (const pending of refreshQueue) {
+            if (token) {
+                pending.resolve(token);
+            }
+            else {
+                pending.reject(error);
+            }
+        }
+        refreshQueue = [];
+    }
+    // ─── Request Interceptor ─────────────────────────────────────────────────
+    instance.interceptors.request.use(async (req) => {
+        var _a, _b, _c;
+        // Stamp start time for logging
+        req[START_TIME_KEY] = Date.now();
+        // Inject auth token
+        if (getToken) {
+            const token = await getToken();
+            if (token) {
+                req.headers = (_a = req.headers) !== null && _a !== void 0 ? _a : {};
+                req.headers["Authorization"] = `Bearer ${token}`;
+            }
+        }
+        logger.request((_b = req.method) !== null && _b !== void 0 ? _b : "GET", (_c = req.url) !== null && _c !== void 0 ? _c : "");
+        return req;
+    }, (error) => Promise.reject(error));
+    // ─── Response Interceptor ────────────────────────────────────────────────
+    instance.interceptors.response.use(async (response) => {
+        var _a, _b;
+        const req = response.config;
+        const start = req[START_TIME_KEY];
+        const duration = start ? Date.now() - start : 0;
+        logger.response((_a = response.config.method) !== null && _a !== void 0 ? _a : "GET", (_b = response.config.url) !== null && _b !== void 0 ? _b : "", response.status, duration);
+        // ── Backend-controlled delay via X-API-Delay header ──
+        const headerDelay = response.headers["x-api-delay"];
+        if (headerDelay) {
+            const ms = parseInt(headerDelay, 10);
+            if (!isNaN(ms) && ms > 0) {
+                logger.info(`Applying backend-controlled delay: ${ms}ms`);
+                await applyDelay(ms);
+            }
+        }
+        // ── Global runtime delay ──
+        else {
+            const delayState = getDelayState();
+            if (delayState.enabled && delayState.duration > 0) {
+                await applyDelay(delayState.duration);
+            }
+        }
+        return response;
+    }, async (error) => {
+        var _a, _b, _c;
+        const originalRequest = error.config;
+        if (!originalRequest) {
+            throw new ApiError(normalizeError(error));
+        }
+        // ── Retry logic for network failures ──
+        const isNetworkError = !error.response && error.request;
+        const currentRetry = (_a = originalRequest[RETRY_COUNT_KEY]) !== null && _a !== void 0 ? _a : 0;
+        if (isNetworkError && currentRetry < retry) {
+            originalRequest[RETRY_COUNT_KEY] = currentRetry + 1;
+            logger.retrying(currentRetry + 1, retry, (_b = originalRequest.url) !== null && _b !== void 0 ? _b : "");
+            return instance(originalRequest);
+        }
+        // ── 401 Token Refresh ──
+        if (((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) === 401 && refreshToken && !originalRequest["__isRetry"]) {
+            originalRequest["__isRetry"] = true;
+            if (isRefreshing) {
+                // Queue this request until refresh completes
+                return new Promise((resolve, reject) => {
+                    refreshQueue.push({
+                        resolve: (newToken) => {
+                            originalRequest.headers["Authorization"] = `Bearer ${newToken}`;
+                            resolve(instance(originalRequest));
+                        },
+                        reject,
+                    });
+                });
+            }
+            isRefreshing = true;
+            logger.tokenRefresh();
+            try {
+                const newToken = await refreshToken();
+                isRefreshing = false;
+                if (!newToken)
+                    throw new Error("Refresh returned empty token");
+                processRefreshQueue(newToken, null);
+                originalRequest.headers["Authorization"] = `Bearer ${newToken}`;
+                return instance(originalRequest);
+            }
+            catch (refreshError) {
+                isRefreshing = false;
+                processRefreshQueue(null, refreshError);
+                logger.logout();
+                onLogout === null || onLogout === void 0 ? void 0 : onLogout();
+                throw new ApiError(normalizeError(error));
+            }
+        }
+        // ── Normalize all other errors ──
+        throw new ApiError(normalizeError(error));
+    });
+    // ─── Public API ──────────────────────────────────────────────────────────
+    return {
+        get(url, config) {
+            return instance.get(url, config);
+        },
+        post(url, data, config) {
+            return instance.post(url, data, config);
+        },
+        put(url, data, config) {
+            return instance.put(url, data, config);
+        },
+        patch(url, data, config) {
+            return instance.patch(url, data, config);
+        },
+        delete(url, config) {
+            return instance.delete(url, config);
+        },
+        request(config) {
+            return instance.request(config);
+        },
+        getAxiosInstance() {
+            return instance;
+        },
+    };
+}
+
+exports.ApiError = ApiError;
+exports.createApiEngine = createApiEngine;
+exports.getDelayState = getDelayState;
+exports.setResponseDelay = setResponseDelay;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/delayManager.ts","../src/logger.ts","../src/errorNormalizer.ts","../src/createApiEngine.ts"],"sourcesContent":[null,null,null,null],"names":["AxiosError"],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+export declare function setLogging(enabled: boolean): void;
+export declare const logger: {
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    request: (method: string, url: string) => void;
+    response: (method: string, url: string, status: number, durationMs: number) => void;
+    retrying: (attempt: number, max: number, url: string) => void;
+    tokenRefresh: () => void;
+    logout: () => void;
+};

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+import { AxiosRequestConfig } from "axios";
+export interface ApiEngineConfig {
+    /** Base URL for all API requests */
+    baseURL: string;
+    /** Async function that returns the current auth token */
+    getToken?: () => Promise<string | null> | string | null;
+    /** Called when a 401 is received; should return a new token */
+    refreshToken?: () => Promise<string | null>;
+    /** Called when token refresh fails — use to redirect to login */
+    onLogout?: () => void;
+    /** Number of retry attempts on network failures (default: 0) */
+    retry?: number;
+    /** Static delay in ms applied to every response (default: 0) */
+    responseDelay?: number;
+    /** Enable request/response logging (default: false) */
+    enableLogging?: boolean;
+    /** Additional Axios config defaults */
+    axiosConfig?: AxiosRequestConfig;
+}
+export interface NormalizedError {
+    status: number;
+    message: string;
+    data: unknown;
+}
+export interface DelayState {
+    enabled: boolean;
+    duration: number;
+}
+export interface ApiEngine {
+    get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    request<T = unknown>(config: AxiosRequestConfig): Promise<T>;
+    getAxiosInstance(): import("axios").AxiosInstance;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "axios-engine",
+  "version": "1.0.0",
+  "description": "A platform-agnostic networking library built on Axios for React Native, React, Next.js, and Node.js",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "axios",
+    "api",
+    "http",
+    "react-native",
+    "react",
+    "nextjs",
+    "nodejs",
+    "networking",
+    "interceptors",
+    "token-refresh"
+  ],
+  "author": "yunush",
+  "license": "MIT",
+  "peerDependencies": {
+    "axios": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "axios": "^1.13.6",
+    "jest": "^29.7.0",
+    "rollup": "^3.0.0",
+    "rollup-plugin-dts": "^6.0.0",
+    "ts-jest": "^29.4.6",
+    "tslib": "^2.6.0",
+    "typescript": "^5.9.3"
+  }
+}