auravia-connect 1.0.0

package/Readme.md

@@ -0,0 +1,28 @@
+# auravia-connect
+
+🚀 Smart frontend–backend connector with built-in mocking, fallback, and debug timeline.
+
+Auravia Connect is a lightweight HTTP client designed to simplify communication between frontend and backend while providing powerful developer tools like smart mocking and automatic fallback.
+
+---
+
+## ✨ Features
+
+- 🔗 Simple HTTP client (GET, POST, PUT, PATCH, DELETE)
+- 🧠 Smart mock generator
+- 🧪 Wildcard route mocking (`/users/:id`)
+- ⏱ Mock delay simulation
+- 🚨 Error simulation
+- 🔄 Smart fallback when network fails
+- 🧩 Request & response interceptors
+- 🧭 Debug timeline
+- ⚙️ Strategy control (prefer mock or network)
+- 📦 Zero dependencies
+- ⚡ Lightweight
+
+---
+
+## 📦 Installation
+
+```bash
+npm install auravia-connect

package/dist/client/createClient.d.ts

@@ -0,0 +1,34 @@
+type ClientConfig = {
+    baseURL?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    mock?: boolean;
+    mockFallback?: boolean;
+    debug?: boolean;
+    mockStrategy?: "prefer-mock" | "prefer-network";
+};
+type ApiResponse<T = any> = {
+    ok: boolean;
+    status: number;
+    data: T | null;
+    error: string | null;
+};
+type MockOptions = {
+    method?: string;
+    delay?: number;
+    count?: number;
+    status?: number;
+};
+export declare function createClient(defaultConfig?: ClientConfig): {
+    get: (url: string) => Promise<ApiResponse<any>>;
+    post: (url: string, body?: any) => Promise<ApiResponse<any>>;
+    put: (url: string, body?: any) => Promise<ApiResponse<any>>;
+    patch: (url: string, body?: any) => Promise<ApiResponse<any>>;
+    delete: (url: string) => Promise<ApiResponse<any>>;
+    onRequest(fn: Function): number;
+    onResponse(fn: Function): number;
+    ejectRequest(id: number): void;
+    ejectResponse(id: number): void;
+    mock(url: string, response: any, options?: MockOptions): void;
+};
+export {};

package/dist/client/createClient.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+function createClient(defaultConfig = {}) {
+    // ===============================
+    // 🔥 INTERCEPTORS
+    // ===============================
+    let interceptorId = 0;
+    const requestInterceptors = [];
+    const responseInterceptors = [];
+    // ===============================
+    // 🔥 MOCK STORAGE
+    // ===============================
+    const mocks = [];
+    // ===============================
+    // 🔥 DEBUG LOGGER
+    // ===============================
+    function debugLog(...args) {
+        if (defaultConfig.debug) {
+            console.log("[auravia]", ...args);
+        }
+    }
+    // ===============================
+    // 🔥 STRATEGY
+    // ===============================
+    function shouldUseMockFirst() {
+        var _a;
+        return (((_a = defaultConfig.mockStrategy) !== null && _a !== void 0 ? _a : "prefer-mock") === "prefer-mock");
+    }
+    // ===============================
+    // 🔥 GENERATORS
+    // ===============================
+    const generators = {
+        text: () => "Sample text",
+        number: () => Math.floor(Math.random() * 1000),
+        boolean: () => Math.random() > 0.5,
+        uuid: () => typeof crypto !== "undefined" && crypto.randomUUID
+            ? crypto.randomUUID()
+            : Math.random().toString(36).slice(2),
+        image: () => `https://picsum.photos/200?random=${Math.random()}`,
+        video: () => "https://samplelib.com/lib/preview/mp4/sample-5s.mp4",
+        mp3: () => "https://samplelib.com/lib/preview/mp3/sample-3s.mp3",
+    };
+    // ===============================
+    // 🔥 SCHEMA RESOLVER
+    // ===============================
+    function resolveSchema(schema) {
+        if (typeof schema === "string" && generators[schema]) {
+            return generators[schema]();
+        }
+        if (Array.isArray(schema)) {
+            return schema.map(item => resolveSchema(item));
+        }
+        if (schema && typeof schema === "object") {
+            const result = {};
+            for (const key in schema) {
+                result[key] = resolveSchema(schema[key]);
+            }
+            return result;
+        }
+        return schema;
+    }
+    // ===============================
+    // 🔥 URL MATCHER
+    // ===============================
+    function matchUrl(mockUrl, requestUrl) {
+        if (mockUrl === requestUrl)
+            return true;
+        const regex = new RegExp("^" + mockUrl.replace(/:[^/]+/g, "[^/]+") + "$");
+        return regex.test(requestUrl);
+    }
+    // ===============================
+    // 🔥 FIND MOCK
+    // ===============================
+    function findMock(config) {
+        return mocks.find(m => {
+            const methodMatch = !m.method || m.method === config.method;
+            const urlMatch = matchUrl(m.url, config.url);
+            return methodMatch && urlMatch;
+        });
+    }
+    // ===============================
+    // 🔥 DELAY
+    // ===============================
+    function sleep(ms) {
+        return new Promise(res => setTimeout(res, ms));
+    }
+    // ===============================
+    // 🔥 BUILD MOCK RESPONSE
+    // ===============================
+    async function buildMockResponse(mock, config) {
+        var _a, _b, _c, _d;
+        if ((_a = mock.options) === null || _a === void 0 ? void 0 : _a.delay) {
+            await sleep(mock.options.delay);
+        }
+        let data = typeof mock.response === "function"
+            ? await mock.response(config)
+            : resolveSchema(mock.response);
+        if (((_b = mock.options) === null || _b === void 0 ? void 0 : _b.count) && mock.options.count > 1) {
+            data = Array.from({ length: mock.options.count }).map(() => resolveSchema(mock.response));
+        }
+        const statusCode = (_d = (_c = mock.options) === null || _c === void 0 ? void 0 : _c.status) !== null && _d !== void 0 ? _d : 200;
+        let mockResponse = {
+            ok: statusCode >= 200 && statusCode < 300,
+            status: statusCode,
+            data,
+            error: statusCode >= 200 && statusCode < 300
+                ? null
+                : "Mock error",
+        };
+        for (const interceptor of responseInterceptors) {
+            mockResponse = await interceptor.fn(mockResponse);
+        }
+        return mockResponse;
+    }
+    // ===============================
+    // 🔥 REQUEST ENGINE
+    // ===============================
+    async function request(method, url, body) {
+        const startTime = Date.now();
+        debugLog("→", method, url);
+        const controller = new AbortController();
+        let config = {
+            method,
+            url,
+            data: body,
+            headers: { ...defaultConfig.headers },
+            baseURL: defaultConfig.baseURL,
+        };
+        // ---------- request interceptors ----------
+        try {
+            for (const interceptor of requestInterceptors) {
+                config = await interceptor.fn(config);
+            }
+        }
+        catch (err) {
+            return {
+                ok: false,
+                status: 0,
+                data: null,
+                error: (err === null || err === void 0 ? void 0 : err.message) || "Request blocked by interceptor",
+            };
+        }
+        // ===============================
+        // 🔥 DIRECT MOCK (strategy aware)
+        // ===============================
+        const directMock = defaultConfig.mock ? findMock(config) : undefined;
+        if (directMock && shouldUseMockFirst()) {
+            debugLog("✓ mock hit");
+            const res = await buildMockResponse(directMock, config);
+            debugLog("⏱", Date.now() - startTime + "ms");
+            return res;
+        }
+        // ===============================
+        // 🔥 REAL FETCH
+        // ===============================
+        const timer = defaultConfig.timeout
+            ? setTimeout(() => controller.abort(), defaultConfig.timeout)
+            : null;
+        try {
+            debugLog("… trying network");
+            const res = await fetch((config.baseURL || "") + config.url, {
+                method: config.method,
+                headers: {
+                    "Content-Type": "application/json",
+                    ...config.headers,
+                },
+                body: config.data && config.method !== "GET"
+                    ? JSON.stringify(config.data)
+                    : undefined,
+                signal: controller.signal,
+            });
+            const contentType = res.headers.get("content-type") || "";
+            let parsed;
+            if (contentType.includes("application/json")) {
+                parsed = await res.json();
+            }
+            else {
+                parsed = await res.text();
+            }
+            let response = {
+                ok: res.ok,
+                status: res.status,
+                data: parsed,
+                error: null,
+            };
+            for (const interceptor of responseInterceptors) {
+                response = await interceptor.fn(response);
+            }
+            debugLog("✓ network");
+            debugLog("⏱", Date.now() - startTime + "ms");
+            return response;
+        }
+        catch (err) {
+            // ===============================
+            // 🔥 SMART FALLBACK
+            // ===============================
+            if (defaultConfig.mock && defaultConfig.mockFallback) {
+                const fallbackMock = findMock(config);
+                if (fallbackMock) {
+                    debugLog("⚠ network failed");
+                    debugLog("✓ fallback mock hit");
+                    const res = await buildMockResponse(fallbackMock, config);
+                    debugLog("⏱", Date.now() - startTime + "ms");
+                    return res;
+                }
+            }
+            debugLog("✗ request failed");
+            debugLog("⏱", Date.now() - startTime + "ms");
+            return {
+                ok: false,
+                status: 500,
+                data: null,
+                error: (err === null || err === void 0 ? void 0 : err.message) || "Network error",
+            };
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    // ===============================
+    // 🔥 PUBLIC API
+    // ===============================
+    return {
+        get: (url) => request("GET", url),
+        post: (url, body) => request("POST", url, body),
+        put: (url, body) => request("PUT", url, body),
+        patch: (url, body) => request("PATCH", url, body),
+        delete: (url) => request("DELETE", url),
+        onRequest(fn) {
+            const id = ++interceptorId;
+            requestInterceptors.push({ id, fn });
+            return id;
+        },
+        onResponse(fn) {
+            const id = ++interceptorId;
+            responseInterceptors.push({ id, fn });
+            return id;
+        },
+        ejectRequest(id) {
+            const i = requestInterceptors.findIndex(x => x.id === id);
+            if (i !== -1)
+                requestInterceptors.splice(i, 1);
+        },
+        ejectResponse(id) {
+            const i = responseInterceptors.findIndex(x => x.id === id);
+            if (i !== -1)
+                responseInterceptors.splice(i, 1);
+        },
+        mock(url, response, options) {
+            if (!defaultConfig.mock) {
+                throw new Error("[auravia-connect] Mock disabled. Use createClient({ mock: true })");
+            }
+            mocks.push({
+                url,
+                method: options === null || options === void 0 ? void 0 : options.method,
+                response,
+                options,
+            });
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const auraviaReady: () => string;
+export { createClient } from "./client/createClient";

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = exports.auraviaReady = void 0;
+const auraviaReady = () => {
+    return "auravia-connect ready";
+};
+exports.auraviaReady = auraviaReady;
+var createClient_1 = require("./client/createClient");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return createClient_1.createClient; } });

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "auravia-connect",
+  "version": "1.0.0",
+  "description": "Smart frontend-backend connector with built-in mocking and fallback",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "http-client",
+    "mock",
+    "api-client",
+    "fetch-wrapper",
+    "testing"
+  ],
+  "author": "Dinesh R",
+  "license": "MIT"
+}