fluxq-engine 1.0.0

package/README.md

@@ -0,0 +1,35 @@
+# 🏥 FluxQ Engine — Telemedicine Queue Optimizer
+
+**FluxQ Engine** is a high-performance REST API for intelligent patient triage and queue optimization. It reduces wait times by up to 40%, improves fairness, and optimizes doctor utilization using ML-based priority scoring.
+
+---
+
+### 🌐 Live API Usage
+**Base URL**: `https://fluxq.onrender.com`  
+**Health Check**: [Online](https://fluxq.onrender.com/health)
+
+---
+
+### ✨ Features
+- **Smart Triage Engine**: Dynamic symptom assessment and severity classification.
+- **Queue Optimization**: Real-time reordering based on clinical severity and fairness thresholds.
+- **Fairness Monitoring**: Aging boosts and starvation risk alerts.
+- **Simulate & Metrics**: Full baseline vs. optimized comparison with 9+ performance KPIs.
+
+### 🔌 API Integration
+You can use this API in any project:
+- **Get Config**: `GET /api/v1/config`
+- **Optimize Queue**: `POST /api/v1/optimize`
+- **Run Simulation**: `POST /api/v1/simulate`
+
+### 🚀 Local Setup
+```bash
+git clone <repo-url>
+cd server
+npm install
+npm start
+```
+
+---
+
+**Developed by Diksha** 🏆

package/dist/api/client.d.ts

@@ -0,0 +1,82 @@
+import { Patient, QueueOptimizationConfig } from "../index";
+export declare class QueueOptimizerClient {
+    private baseUrl;
+    private timeout;
+    constructor(baseUrl?: string, timeout?: number);
+    private request;
+    optimize(patients: Patient[], config?: Partial<QueueOptimizationConfig>): Promise<{
+        success: boolean;
+        data?: {
+            optimizedQueue: any[];
+        };
+        error?: string;
+        message?: string;
+    }>;
+    simulate(patients: Patient[], config?: Partial<QueueOptimizationConfig>): Promise<{
+        success: boolean;
+        data?: {
+            baselineQueue: any[];
+            optimizedQueue: any[];
+            baselineMetrics: any;
+            optimizedMetrics: any;
+            improvements: any;
+            recommendations: string[];
+        };
+        error?: string;
+        message?: string;
+    }>;
+    compare(patients: Patient[], config?: Partial<QueueOptimizationConfig>): Promise<{
+        success: boolean;
+        data?: {
+            baseline: any;
+            optimized: any;
+            improvements: any;
+        };
+        error?: string;
+        message?: string;
+    }>;
+    metrics(patients: Patient[], config?: Partial<QueueOptimizationConfig>): Promise<{
+        success: boolean;
+        data?: {
+            metrics: any;
+        };
+        error?: string;
+        message?: string;
+    }>;
+    getConfig(): Promise<{
+        success: boolean;
+        data?: {
+            config: QueueOptimizationConfig;
+            description: any;
+        };
+        error?: string;
+        message?: string;
+    }>;
+    validateConfig(config: QueueOptimizationConfig): Promise<{
+        success: boolean;
+        data?: {
+            valid: boolean;
+            weightSum: string;
+            errors: string[];
+        };
+        error?: string;
+        message?: string;
+    }>;
+    getDocs(): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+        message?: string;
+    }>;
+    health(): Promise<{
+        status: string;
+        timestamp: string;
+        environment: string;
+        uptime: number;
+    }>;
+    setBaseUrl(baseUrl: string): void;
+    setTimeout(timeout: number): void;
+}
+export declare const apiClient: QueueOptimizerClient;
+export default apiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/client.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiClient = exports.QueueOptimizerClient = void 0;
+class QueueOptimizerClient {
+    constructor(baseUrl = "http://localhost:3000/api/v1", timeout = 30000) {
+        this.baseUrl = baseUrl;
+        this.timeout = timeout;
+    }
+    async request(method, endpoint, body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const options = {
+                method,
+                signal: controller.signal,
+                headers: {
+                    "Content-Type": "application/json",
+                },
+            };
+            if (body) {
+                options.body = JSON.stringify(body);
+            }
+            const response = await fetch(url, options);
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorData = (await response.json());
+                throw new Error(errorData?.message || `HTTP ${response.status}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error.name === "AbortError") {
+                throw new Error("Request timeout");
+            }
+            throw error;
+        }
+    }
+    async optimize(patients, config) {
+        return this.request("POST", "/optimize", { patients, config });
+    }
+    async simulate(patients, config) {
+        return this.request("POST", "/simulate", { patients, config });
+    }
+    async compare(patients, config) {
+        return this.request("POST", "/compare", { patients, config });
+    }
+    async metrics(patients, config) {
+        return this.request("POST", "/metrics", { patients, config });
+    }
+    async getConfig() {
+        return this.request("GET", "/config");
+    }
+    async validateConfig(config) {
+        return this.request("POST", "/config/validate", { config });
+    }
+    async getDocs() {
+        return this.request("GET", "/docs");
+    }
+    async health() {
+        const response = await fetch(`${this.baseUrl.replace("/api/v1", "")}/health`);
+        return (await response.json());
+    }
+    setBaseUrl(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    setTimeout(timeout) {
+        this.timeout = timeout;
+    }
+}
+exports.QueueOptimizerClient = QueueOptimizerClient;
+exports.apiClient = new QueueOptimizerClient();
+exports.default = exports.apiClient;
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/controllers.d.ts

@@ -0,0 +1,12 @@
+import { Request, Response } from "express";
+export declare const optimizeQueueController: (req: Request, res: Response) => Promise<void>;
+export declare const simulateQueueController: (req: Request, res: Response) => Promise<void>;
+export declare const compareQueuesController: (req: Request, res: Response) => Promise<void>;
+export declare const metricsController: (req: Request, res: Response) => Promise<void>;
+export declare const getConfigController: (req: Request, res: Response) => void;
+export declare const configController: (req: Request, res: Response) => void;
+export declare const docsController: (req: Request, res: Response) => void;
+export declare const classifyIntakeController: (req: Request, res: Response) => Promise<Response<any, Record<string, any>> | undefined>;
+export declare const enqueueIntakeController: (req: Request, res: Response) => Promise<Response<any, Record<string, any>> | undefined>;
+export declare const intakeQuestionsController: (req: Request, res: Response) => Response<any, Record<string, any>> | undefined;
+//# sourceMappingURL=controllers.d.ts.map

package/dist/api/controllers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllers.d.ts","sourceRoot":"","sources":["../../src/api/controllers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAwE5C,eAAO,MAAM,uBAAuB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,kBAsBxE,CAAC;AAMF,eAAO,MAAM,uBAAuB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,kBA4BxE,CAAC;AAMF,eAAO,MAAM,uBAAuB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,kBA6BxE,CAAC;AAMF,eAAO,MAAM,iBAAiB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,kBAqBlE,CAAC;AAMF,eAAO,MAAM,mBAAmB,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,SAO9D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,SAW3D,CAAC;AAMF,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,SA8BzD,CAAC;AAUF,eAAO,MAAM,wBAAwB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,4DAwCzE,CAAC;AAMF,eAAO,MAAM,uBAAuB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,4DAwExE,CAAC;AAKF,eAAO,MAAM,yBAAyB,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,mDA2PpE,CAAC"}