opticore-api-gateway 1.0.0 → 1.0.1

package/README.md

@@ -2,7 +2,7 @@
 
 A flexible, production-ready API Gateway built in TypeScript, powered by the [Opticore](https://github.com/guyzoum77) ecosystem. It provides dynamic routing, load balancing, middleware chaining, circuit breaking, and service registry out of the box.
 
----
+
 
 ## Table of Contents
 
@@ -27,7 +27,7 @@ A flexible, production-ready API Gateway built in TypeScript, powered by the [Op
 - [Error Handling](#error-handling)
 - [License](#license)
 
----
+
 
 ## Features
 
@@ -41,33 +41,7 @@ A flexible, production-ready API Gateway built in TypeScript, powered by the [Op
 - **Validation** — Built-in `ValidationMiddleware` using `opticore-validator`
 - **opticore-webapp Integration** — Drop-in replacement for `registerRouter()` in any Opticore template project
 
----
-
-**Request lifecycle:**
-
-```
-Incoming request
-   │
-   ▼
-Global middlewares (auth, rate-limit, logging, …)
-   │
-   ▼
-Route matched by method + path prefix
-   │
-   ▼
-Route-level middlewares
-   │
-   ▼
-Load balancer selects a healthy service instance
-   │
-   ▼
-Request forwarded to target with tracing headers
-   │
-   ▼
-Response sent back to client
-```
 
----
 
 ## Installation
 
@@ -77,7 +51,7 @@ npm install opticore-api-gateway
 
 > Requires Node.js >= 16 and TypeScript >= 5.
 
----
+
 
 ## Quick Start — Standalone mode
 
@@ -144,7 +118,7 @@ await gateway.start();
 // → Registered 2 routes
 ```
 
----
+
 
 ## Integration with opticore-webapp
 
@@ -222,7 +196,7 @@ expressApp.use(gateway.getExpressMiddleware());
 - The handler restores `req.url` to `req.originalUrl` (full path) before proxying so URL rewriting is correct
 - Global middlewares run before the proxy forward for every matched request
 
----
+
 
 ## Configuration
 
@@ -238,7 +212,7 @@ expressApp.use(gateway.getExpressMiddleware());
 | `enableLogging`     | `boolean`                | ❌        | Logs request duration when `true`             |
 | `enableMetrics`     | `boolean`                | ❌        | Reserved for future metrics collection        |
 
----
+
 
 ### `IRouteConfig` interface
 
@@ -253,7 +227,7 @@ expressApp.use(gateway.getExpressMiddleware());
 | `circuitBreaker` | `ICircuitBreakerConfig` | ❌        | Circuit breaker configuration                          |
 | `serviceName`    | `string`                | ❌        | Explicit service name override for registry lookup     |
 
----
+
 
 ### `IServiceConfig` interface
 
@@ -266,7 +240,7 @@ expressApp.use(gateway.getExpressMiddleware());
 | `timeout`     | `number` | ❌        | Default request timeout in ms                 |
 | `retries`     | `number` | ❌        | Default retry count                           |
 
----
+
 
 ### `ICircuitBreakerConfig` interface
 
@@ -281,7 +255,7 @@ Circuit states:
 - **`open`** — Service is unhealthy. Requests fail fast (503).
 - **`half-open`** — Limited probing to test recovery.
 
----
+
 
 ## Load Balancing Strategies
 
@@ -314,7 +288,7 @@ Multi-target route (load balancing across instances):
 }
 ```
 
----
+
 
 ## Middleware
 
@@ -439,7 +413,7 @@ export class CorsMiddleware extends BaseMiddleware {
 }
 ```
 
----
+
 
 ## API Reference
 
@@ -465,7 +439,7 @@ new APIGateway(config: IGatewayConfig)
 | `getOpticoreRoutes(): TFeatureRoutes[]`      | Returns routes compatible with `WebServerCore.onStartServer()`          |
 | `getExpressMiddleware()`                     | Returns global middlewares as a single Express middleware function      |
 
----
+
 
 ### `GatewayRoute`
 
@@ -488,7 +462,7 @@ new GatewayRoute(config: IRouteConfig, handler: TRouteHandler, localLanguage: st
 | `getMultipleRouteDefinition()`                                | `IMultipleRouteDefinition`| Returns the collection router definition     |
 | `GatewayRoute.createOpticoreRouteDefinition(path, handler)`   | `{ path, handler }`       | Static factory for Opticore route entries    |
 
----
+
 
 ### `ServiceRegistry`
 
@@ -503,7 +477,7 @@ Manages service instances and health state.
 | `deregisterService(serviceName, url)`      | Removes an instance and clears its health check        |
 | `getAllServices()`                         | Returns the full service map                           |
 
----
+
 
 ### `LoadBalancer`
 
@@ -515,7 +489,7 @@ const instance = lb.selectInstance('user-service', healthyInstances);
 lb.setStrategy('round-robin');
 ```
 
----
+
 
 ### `HttpClient`
 
@@ -534,7 +508,7 @@ const response = await client.request('http://service:4000/api', {
 
 Convenience methods: `client.get(url)`, `client.post(url, body)`, `client.put(url, body)`, `client.patch(url, body)`, `client.delete(url)`.
 
----
+
 
 ## Types & Interfaces
 
@@ -551,7 +525,7 @@ Convenience methods: `client.get(url)`, `client.post(url, body)`, `client.put(ur
 | `IHttpRequestOptions`    | Options passed to `HttpClient.request()`                     |
 | `IHttpResponse`          | Response shape returned by `HttpClient`                      |
 
----
+
 
 ## Advanced Usage
 
@@ -596,7 +570,7 @@ type TGatewayContext = ICustomContext & {
 };
 ```
 
----
+
 
 ## Error Handling
 
@@ -611,7 +585,7 @@ type TGatewayContext = ICustomContext & {
 | Invalid API key            | `403`       | `{ "error": "Invalid API key" }`                |
 | Rate limit exceeded        | `429`       | `{ "error": "Too many requests", "retryAfter": N }` |
 
----
+
 
 ## License
 

package/dist/index.cjs

@@ -691,30 +691,19 @@ var APIGateway = class {
     const gatewayFeature = { routes: [] };
     this.routes.forEach((gatewayRoute) => {
       const config = gatewayRoute.getConfig();
-      const standaloneRouter = new import_opticore_router2.OpticoreStandaloneRouterFactory();
-      const contextHandler = async (context) => {
-        const { req, res } = context;
+      const expressHandler = (req, res, next) => {
         req.url = req.originalUrl || req.url;
-        return new Promise((resolve) => {
-          this.middlewareChain.execute(req, res, (_r, _s, _n) => {
-            this.handleGatewayRequest(req, res, config).then(resolve).catch(() => {
-              if (!res.headersSent) {
-                res.statusCode = 502;
-                res.end(JSON.stringify({ error: "Bad Gateway" }));
-              }
-              resolve();
-            });
+        this.middlewareChain.execute(req, res, (_r, _s, _n) => {
+          this.handleGatewayRequest(req, res, config).catch(() => {
+            if (!res.headersSent) {
+              res.status(502).send(JSON.stringify({ error: "Bad Gateway" }));
+            }
           });
         });
       };
-      standaloneRouter.storeRoute(
-        config.method,
-        "*",
-        contextHandler
-      );
       gatewayFeature.routes.push({
         path: config.path,
-        handler: standaloneRouter.getRoute()
+        handler: expressHandler
       });
     });
     featureRoutes.push(gatewayFeature);
@@ -744,14 +733,12 @@ var APIGateway = class {
         serviceName = routeConfig.serviceName || this.extractServiceName(routeConfig.target[0]);
         const instances = this.serviceRegistry.getHealthyInstances(serviceName);
         if (instances.length === 0) {
-          res.statusCode = 503;
-          res.end(JSON.stringify({ error: "Service unavailable" }));
+          res.status(503).send(JSON.stringify({ error: "Service unavailable" }));
           return;
         }
         const instance = this.loadBalancer.selectInstance(serviceName, instances);
         if (!instance) {
-          res.statusCode = 503;
-          res.end(JSON.stringify({ error: "No healthy instances available" }));
+          res.status(503).send(JSON.stringify({ error: "No healthy instances available" }));
           return;
         }
         serviceUrl = this.rewriteUrl(req.url, instance.url, routeConfig.target[0]);
@@ -764,8 +751,7 @@ var APIGateway = class {
         serviceName = routeConfig.serviceName || this.extractServiceName(routeConfig.target);
         const instances = this.serviceRegistry.getHealthyInstances(serviceName);
         if (instances.length === 0) {
-          res.statusCode = 503;
-          res.end(JSON.stringify({ error: "Service unavailable" }));
+          res.status(503).send(JSON.stringify({ error: "Service unavailable" }));
           return;
         }
         const instance = instances[0];
@@ -778,8 +764,7 @@ var APIGateway = class {
       }
     } catch (error) {
       console.error("Gateway error:", error);
-      res.statusCode = 502;
-      res.end(JSON.stringify({
+      res.status(502).send(JSON.stringify({
         error: "Bad Gateway",
         message: error instanceof Error ? error.message : "Unknown error"
       }));
@@ -835,15 +820,16 @@ var APIGateway = class {
   }
   sendResponse(res, httpResponse) {
     if (httpResponse.headers) {
+      const skipHeaders = /* @__PURE__ */ new Set(["content-length", "transfer-encoding", "content-encoding"]);
       Object.keys(httpResponse.headers).forEach((key) => {
+        if (skipHeaders.has(key.toLowerCase())) return;
         const value = httpResponse.headers[key];
         if (value !== void 0) {
           res.setHeader(key, value);
         }
       });
     }
-    res.statusCode = httpResponse.status;
-    res.end(httpResponse.body);
+    res.status(httpResponse.status).send(httpResponse.body);
   }
   addRoute(routeConfig) {
     const handler = async (req, res, next) => {

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/core/gateway.core.ts
 import * as http2 from "http";
-import { OpticoreRegisterRouter, OpticoreStandaloneRouterFactory as OpticoreStandaloneRouterFactory2 } from "opticore-router";
+import { OpticoreRegisterRouter } from "opticore-router";
 
 // src/infrastructure/services/strategies/serviceRegistry.strategy.ts
 var ServiceRegistry = class {
@@ -648,30 +648,19 @@ var APIGateway = class {
     const gatewayFeature = { routes: [] };
     this.routes.forEach((gatewayRoute) => {
       const config = gatewayRoute.getConfig();
-      const standaloneRouter = new OpticoreStandaloneRouterFactory2();
-      const contextHandler = async (context) => {
-        const { req, res } = context;
+      const expressHandler = (req, res, next) => {
         req.url = req.originalUrl || req.url;
-        return new Promise((resolve) => {
-          this.middlewareChain.execute(req, res, (_r, _s, _n) => {
-            this.handleGatewayRequest(req, res, config).then(resolve).catch(() => {
-              if (!res.headersSent) {
-                res.statusCode = 502;
-                res.end(JSON.stringify({ error: "Bad Gateway" }));
-              }
-              resolve();
-            });
+        this.middlewareChain.execute(req, res, (_r, _s, _n) => {
+          this.handleGatewayRequest(req, res, config).catch(() => {
+            if (!res.headersSent) {
+              res.status(502).send(JSON.stringify({ error: "Bad Gateway" }));
+            }
           });
         });
       };
-      standaloneRouter.storeRoute(
-        config.method,
-        "*",
-        contextHandler
-      );
       gatewayFeature.routes.push({
         path: config.path,
-        handler: standaloneRouter.getRoute()
+        handler: expressHandler
       });
     });
     featureRoutes.push(gatewayFeature);
@@ -701,14 +690,12 @@ var APIGateway = class {
         serviceName = routeConfig.serviceName || this.extractServiceName(routeConfig.target[0]);
         const instances = this.serviceRegistry.getHealthyInstances(serviceName);
         if (instances.length === 0) {
-          res.statusCode = 503;
-          res.end(JSON.stringify({ error: "Service unavailable" }));
+          res.status(503).send(JSON.stringify({ error: "Service unavailable" }));
           return;
         }
         const instance = this.loadBalancer.selectInstance(serviceName, instances);
         if (!instance) {
-          res.statusCode = 503;
-          res.end(JSON.stringify({ error: "No healthy instances available" }));
+          res.status(503).send(JSON.stringify({ error: "No healthy instances available" }));
           return;
         }
         serviceUrl = this.rewriteUrl(req.url, instance.url, routeConfig.target[0]);
@@ -721,8 +708,7 @@ var APIGateway = class {
         serviceName = routeConfig.serviceName || this.extractServiceName(routeConfig.target);
         const instances = this.serviceRegistry.getHealthyInstances(serviceName);
         if (instances.length === 0) {
-          res.statusCode = 503;
-          res.end(JSON.stringify({ error: "Service unavailable" }));
+          res.status(503).send(JSON.stringify({ error: "Service unavailable" }));
           return;
         }
         const instance = instances[0];
@@ -735,8 +721,7 @@ var APIGateway = class {
       }
     } catch (error) {
       console.error("Gateway error:", error);
-      res.statusCode = 502;
-      res.end(JSON.stringify({
+      res.status(502).send(JSON.stringify({
         error: "Bad Gateway",
         message: error instanceof Error ? error.message : "Unknown error"
       }));
@@ -792,15 +777,16 @@ var APIGateway = class {
   }
   sendResponse(res, httpResponse) {
     if (httpResponse.headers) {
+      const skipHeaders = /* @__PURE__ */ new Set(["content-length", "transfer-encoding", "content-encoding"]);
       Object.keys(httpResponse.headers).forEach((key) => {
+        if (skipHeaders.has(key.toLowerCase())) return;
         const value = httpResponse.headers[key];
         if (value !== void 0) {
           res.setHeader(key, value);
         }
       });
     }
-    res.statusCode = httpResponse.status;
-    res.end(httpResponse.body);
+    res.status(httpResponse.status).send(httpResponse.body);
   }
   addRoute(routeConfig) {
     const handler = async (req, res, next) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opticore-api-gateway",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OptiCore API Gateway",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -33,11 +33,11 @@
     "ansi-colors": "^4.1.3",
     "chalk": "^5.6.2",
     "gradient-string": "^3.0.0",
-    "opticore-http-response": "^1.0.9",
-    "opticore-logger": "^1.0.29",
-    "opticore-router": "^1.0.20",
-    "opticore-translator": "^1.0.13",
-    "opticore-validator": "^1.0.3"
+    "opticore-http-response": "^1.0.11",
+    "opticore-logger": "^1.0.32",
+    "opticore-router": "^1.0.22",
+    "opticore-translator": "^1.0.16",
+    "opticore-validator": "^1.0.4"
   },
   "devDependencies": {
     "@types/gradient-string": "^1.1.6",