@infodb/revx 0.1.0

package/dist/utils/proxy.js

@@ -0,0 +1,134 @@
+import { createProxyMiddleware } from 'http-proxy-middleware';
+export class LoadBalancer {
+    constructor(targets, strategy = 'round-robin', logger) {
+        this.targets = targets;
+        this.strategy = strategy;
+        this.logger = logger;
+        this.currentIndex = 0;
+        this.targetHealth = new Map();
+        targets.forEach(target => this.targetHealth.set(target, true));
+    }
+    getTarget(req) {
+        const healthyTargets = this.targets.filter(t => this.targetHealth.get(t));
+        if (healthyTargets.length === 0) {
+            this.logger.warning('All targets are unhealthy, using first target');
+            return this.targets[0];
+        }
+        switch (this.strategy) {
+            case 'random':
+                return healthyTargets[Math.floor(Math.random() * healthyTargets.length)];
+            case 'ip-hash':
+                if (req) {
+                    const ip = req.ip || req.socket.remoteAddress || '';
+                    const hash = this.hashCode(ip);
+                    return healthyTargets[Math.abs(hash) % healthyTargets.length];
+                }
+                return healthyTargets[0];
+            case 'round-robin':
+            default:
+                const target = healthyTargets[this.currentIndex % healthyTargets.length];
+                this.currentIndex = (this.currentIndex + 1) % healthyTargets.length;
+                return target;
+        }
+    }
+    markUnhealthy(target) {
+        this.targetHealth.set(target, false);
+        this.logger.warning(`Target marked as unhealthy: ${target}`);
+    }
+    markHealthy(target) {
+        this.targetHealth.set(target, true);
+        this.logger.verbose(`Target marked as healthy: ${target}`);
+    }
+    hashCode(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return hash;
+    }
+}
+export class ProxyManager {
+    constructor(logger) {
+        this.logger = logger;
+        this.loadBalancers = new Map();
+    }
+    createProxyMiddleware(route) {
+        const options = {
+            changeOrigin: route.changeOrigin ?? true,
+            ws: route.ws ?? false,
+            pathRewrite: route.pathRewrite,
+            timeout: route.options?.timeout,
+            followRedirects: route.options?.followRedirects,
+            on: {
+                proxyReq: (proxyReq, req) => {
+                    if (route.options?.headers) {
+                        Object.entries(route.options.headers).forEach(([key, value]) => {
+                            proxyReq.setHeader(key, value);
+                        });
+                    }
+                    if (route.transform?.request?.headers?.add) {
+                        Object.entries(route.transform.request.headers.add).forEach(([key, value]) => {
+                            proxyReq.setHeader(key, value);
+                        });
+                    }
+                    if (route.transform?.request?.headers?.remove) {
+                        route.transform.request.headers.remove.forEach(header => {
+                            proxyReq.removeHeader(header);
+                        });
+                    }
+                    this.logger.verbose('Proxy request', {
+                        method: req.method,
+                        path: req.url,
+                        target: proxyReq.getHeader('host')
+                    });
+                },
+                proxyRes: (proxyRes, req, res) => {
+                    if (route.transform?.response?.headers?.add) {
+                        Object.entries(route.transform.response.headers.add).forEach(([key, value]) => {
+                            proxyRes.headers[key.toLowerCase()] = value;
+                        });
+                    }
+                    if (route.transform?.response?.headers?.remove) {
+                        route.transform.response.headers.remove.forEach(header => {
+                            delete proxyRes.headers[header.toLowerCase()];
+                        });
+                    }
+                    this.logger.verbose('Proxy response', {
+                        statusCode: proxyRes.statusCode,
+                        path: req.url
+                    });
+                },
+                error: (err, req, res) => {
+                    this.logger.error(`Proxy error: ${err.message}`);
+                    const serverRes = res;
+                    if (!serverRes.headersSent) {
+                        serverRes.writeHead(502, { 'Content-Type': 'application/json' });
+                    }
+                    serverRes.end(JSON.stringify({
+                        error: 'Bad Gateway',
+                        message: 'Failed to proxy request'
+                    }));
+                }
+            }
+        };
+        if (route.targets && route.targets.length > 0) {
+            const balancer = new LoadBalancer(route.targets, route.strategy || 'round-robin', this.logger);
+            this.loadBalancers.set(route.path, balancer);
+            options.router = (req) => {
+                return balancer.getTarget(req);
+            };
+            this.logger.info(`Load balancer configured for ${route.path} with ${route.targets.length} targets (${route.strategy || 'round-robin'})`);
+        }
+        else if (route.target) {
+            options.target = route.target;
+            this.logger.info(`Proxy configured: ${route.path} -> ${route.target}`);
+        }
+        return createProxyMiddleware(options);
+    }
+    getLoadBalancer(path) {
+        return this.loadBalancers.get(path);
+    }
+}
+//# sourceMappingURL=proxy.js.map

package/dist/utils/proxy.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@infodb/revx",
+  "version": "0.1.0",
+  "description": "Reverse proxy CLI tool with YAML configuration",
+  "homepage": "https://github.com/tamuto/infodb-cli/",
+  "bugs": "https://github.com/tamuto/infodb-cli/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tamuto/infodb-cli",
+    "directory": "revx"
+  },
+  "keywords": [
+    "reverse-proxy",
+    "proxy",
+    "cli",
+    "express",
+    "yaml",
+    "http-proxy"
+  ],
+  "author": "tamuto <tamuto@infodb.jp>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "revx": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "sample"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "cors": "^2.8.5",
+    "express": "^5.1.0",
+    "http-proxy-middleware": "^3.0.3",
+    "morgan": "^1.10.0",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.5",
+    "@types/morgan": "^1.9.9",
+    "@types/node": "^24.10.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  }
+}

package/sample/revx.simple.yaml

@@ -0,0 +1,15 @@
+# revx.simple.yaml - Simple Reverse Proxy Configuration
+
+server:
+  port: 3000
+
+routes:
+  - path: "/api/*"
+    target: "http://localhost:4000"
+    pathRewrite:
+      "^/api": ""
+
+  - path: "/auth/*"
+    target: "http://localhost:5000"
+    pathRewrite:
+      "^/auth": ""

package/sample/revx.yaml

@@ -0,0 +1,95 @@
+# revx.yaml - Reverse Proxy Configuration Example
+
+# Server settings
+server:
+  port: 3000
+  host: 0.0.0.0
+  name: "My Reverse Proxy"
+
+# Global configuration
+global:
+  # Request timeout in milliseconds
+  timeout: 30000
+
+  # CORS settings
+  cors:
+    enabled: true
+    origin: "*"
+    methods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"]
+    credentials: true
+
+  # Logging settings
+  logging:
+    enabled: true
+    format: "combined"  # combined | dev | common | short | tiny
+    level: "info"       # error | warn | info | debug
+
+# Route definitions
+routes:
+  # Example 1: Simple proxy to API server
+  - path: "/api/*"
+    target: "http://localhost:4000"
+    changeOrigin: true
+    pathRewrite:
+      "^/api": ""
+    options:
+      timeout: 5000
+      headers:
+        X-Forwarded-Host: "${HOST}"
+
+  # Example 2: WebSocket proxy
+  - path: "/ws"
+    target: "ws://localhost:5000"
+    ws: true
+    changeOrigin: true
+
+  # Example 3: Load balancing with multiple targets
+  - path: "/balanced/*"
+    targets:
+      - "http://localhost:8001"
+      - "http://localhost:8002"
+      - "http://localhost:8003"
+    strategy: "round-robin"  # round-robin | random | ip-hash
+    pathRewrite:
+      "^/balanced": ""
+    healthCheck:
+      enabled: true
+      interval: 30000
+      path: "/health"
+      timeout: 3000
+
+  # Example 4: Request/Response transformation
+  - path: "/transform/*"
+    target: "http://localhost:6000"
+    changeOrigin: true
+    transform:
+      request:
+        headers:
+          add:
+            X-API-Version: "v2"
+          remove:
+            - "Cookie"
+      response:
+        headers:
+          add:
+            X-Proxy-Server: "revx"
+          remove:
+            - "Server"
+
+# Middleware configuration
+middleware:
+  # Request ID middleware
+  - type: "requestId"
+    enabled: true
+    headerName: "X-Request-ID"
+
+  # Compression middleware
+  - type: "compression"
+    enabled: true
+    threshold: 1024
+
+# SSL/TLS settings (optional)
+# ssl:
+#   enabled: false
+#   key: "/path/to/private.key"
+#   cert: "/path/to/certificate.crt"