@gagandeep023/api-gateway 0.4.2 → 0.5.0

package/dist/backend/index.d.mts

@@ -1,5 +1,5 @@
 import { Router, Request, Response, NextFunction } from 'express';
-import { RateLimitConfig, RequestLog, GatewayAnalytics, DeviceEntry, GatewayMiddlewareConfig, ApiKeysConfig, IpRules } from '../types/index.mjs';
+import { RateLimitConfig, LogConfig, RequestLog, GatewayAnalytics, DeviceEntry, GatewayMiddlewareConfig, ApiKeysConfig, IpRules } from '../types/index.mjs';
 
 declare class RateLimiterService {
     private tokenBucket;
@@ -23,7 +23,10 @@ declare class AnalyticsService {
     private logs;
     private head;
     private count;
+    private fileLogWriter;
+    constructor(logConfig?: LogConfig);
     addLog(log: RequestLog): void;
+    destroy(): void;
     getRecentLogs(limit?: number, offset?: number): RequestLog[];
     getAnalytics(rateLimitHits: number): GatewayAnalytics;
     private getOrderedLogs;
@@ -67,7 +70,7 @@ interface GatewayInstances {
     analyticsService: AnalyticsService;
     deviceRegistry?: DeviceRegistryService;
     middleware: Router;
-    config: Required<GatewayMiddlewareConfig>;
+    config: Required<Omit<GatewayMiddlewareConfig, 'logConfig'>> & Pick<GatewayMiddlewareConfig, 'logConfig'>;
 }
 declare function createGatewayMiddleware(userConfig?: GatewayMiddlewareConfig): GatewayInstances;
 
@@ -83,6 +86,23 @@ interface DeviceAuthRoutesOptions {
 }
 declare function createDeviceAuthRoutes(options: DeviceAuthRoutesOptions): Router;
 
+declare class FileLogWriter {
+    private logDir;
+    private appName;
+    private maxLines;
+    private currentDate;
+    private currentLines;
+    private fileIndex;
+    private currentFilePath;
+    private destroyed;
+    constructor(config: LogConfig);
+    write(log: RequestLog): void;
+    destroy(): void;
+    /** Scan existing log files for a date to determine the next incremental number. */
+    private scanExistingFiles;
+    private rotateFile;
+}
+
 declare function createApiKeyAuth(getKeys: () => ApiKeysConfig, deviceRegistry?: DeviceRegistryService): (req: Request, res: Response, next: NextFunction) => void;
 
 declare function createIpFilter(getRules: () => IpRules): (req: Request, res: Response, next: NextFunction) => void;
@@ -100,4 +120,4 @@ declare function parseKey(key: string): {
 } | null;
 declare function generateSecret(): string;
 
-export { AnalyticsService, type DeviceAuthRoutesOptions, DeviceRegistryService, type GatewayInstances, type GatewayRoutesOptions, RateLimiterService, createApiKeyAuth, createDeviceAuthRoutes, createGatewayMiddleware, createGatewayRoutes, createIpFilter, createRateLimiter, createRequestLogger, formatKey, generateSecret, generateTOTP, parseKey, validateTOTP };
+export { AnalyticsService, type DeviceAuthRoutesOptions, DeviceRegistryService, FileLogWriter, type GatewayInstances, type GatewayRoutesOptions, RateLimiterService, createApiKeyAuth, createDeviceAuthRoutes, createGatewayMiddleware, createGatewayRoutes, createIpFilter, createRateLimiter, createRequestLogger, formatKey, generateSecret, generateTOTP, parseKey, validateTOTP };

package/dist/backend/index.d.ts

@@ -1,5 +1,5 @@
 import { Router, Request, Response, NextFunction } from 'express';
-import { RateLimitConfig, RequestLog, GatewayAnalytics, DeviceEntry, GatewayMiddlewareConfig, ApiKeysConfig, IpRules } from '../types/index.js';
+import { RateLimitConfig, LogConfig, RequestLog, GatewayAnalytics, DeviceEntry, GatewayMiddlewareConfig, ApiKeysConfig, IpRules } from '../types/index.js';
 
 declare class RateLimiterService {
     private tokenBucket;
@@ -23,7 +23,10 @@ declare class AnalyticsService {
     private logs;
     private head;
     private count;
+    private fileLogWriter;
+    constructor(logConfig?: LogConfig);
     addLog(log: RequestLog): void;
+    destroy(): void;
     getRecentLogs(limit?: number, offset?: number): RequestLog[];
     getAnalytics(rateLimitHits: number): GatewayAnalytics;
     private getOrderedLogs;
@@ -67,7 +70,7 @@ interface GatewayInstances {
     analyticsService: AnalyticsService;
     deviceRegistry?: DeviceRegistryService;
     middleware: Router;
-    config: Required<GatewayMiddlewareConfig>;
+    config: Required<Omit<GatewayMiddlewareConfig, 'logConfig'>> & Pick<GatewayMiddlewareConfig, 'logConfig'>;
 }
 declare function createGatewayMiddleware(userConfig?: GatewayMiddlewareConfig): GatewayInstances;
 
@@ -83,6 +86,23 @@ interface DeviceAuthRoutesOptions {
 }
 declare function createDeviceAuthRoutes(options: DeviceAuthRoutesOptions): Router;
 
+declare class FileLogWriter {
+    private logDir;
+    private appName;
+    private maxLines;
+    private currentDate;
+    private currentLines;
+    private fileIndex;
+    private currentFilePath;
+    private destroyed;
+    constructor(config: LogConfig);
+    write(log: RequestLog): void;
+    destroy(): void;
+    /** Scan existing log files for a date to determine the next incremental number. */
+    private scanExistingFiles;
+    private rotateFile;
+}
+
 declare function createApiKeyAuth(getKeys: () => ApiKeysConfig, deviceRegistry?: DeviceRegistryService): (req: Request, res: Response, next: NextFunction) => void;
 
 declare function createIpFilter(getRules: () => IpRules): (req: Request, res: Response, next: NextFunction) => void;
@@ -100,4 +120,4 @@ declare function parseKey(key: string): {
 } | null;
 declare function generateSecret(): string;
 
-export { AnalyticsService, type DeviceAuthRoutesOptions, DeviceRegistryService, type GatewayInstances, type GatewayRoutesOptions, RateLimiterService, createApiKeyAuth, createDeviceAuthRoutes, createGatewayMiddleware, createGatewayRoutes, createIpFilter, createRateLimiter, createRequestLogger, formatKey, generateSecret, generateTOTP, parseKey, validateTOTP };
+export { AnalyticsService, type DeviceAuthRoutesOptions, DeviceRegistryService, FileLogWriter, type GatewayInstances, type GatewayRoutesOptions, RateLimiterService, createApiKeyAuth, createDeviceAuthRoutes, createGatewayMiddleware, createGatewayRoutes, createIpFilter, createRateLimiter, createRequestLogger, formatKey, generateSecret, generateTOTP, parseKey, validateTOTP };

package/dist/backend/index.js

@@ -32,6 +32,7 @@ var backend_exports = {};
 __export(backend_exports, {
   AnalyticsService: () => AnalyticsService,
   DeviceRegistryService: () => DeviceRegistryService,
+  FileLogWriter: () => FileLogWriter,
   RateLimiterService: () => RateLimiterService,
   createApiKeyAuth: () => createApiKeyAuth,
   createDeviceAuthRoutes: () => createDeviceAuthRoutes,
@@ -176,6 +177,140 @@ var RateLimiterService = class {
   }
 };
 
+// src/backend/services/FileLogWriter.ts
+var import_fs = require("fs");
+var import_path = require("path");
+var import_crypto = require("crypto");
+
+// src/config/defaults.ts
+var DEFAULT_LOG_MAX_LINES = 1e4;
+var DEFAULT_RATE_LIMIT_CONFIG = {
+  tiers: {
+    free: { algorithm: "tokenBucket", maxRequests: 100, windowMs: 6e4, refillRate: 10 },
+    pro: { algorithm: "slidingWindow", maxRequests: 1e3, windowMs: 6e4 },
+    unlimited: { algorithm: "none" }
+  },
+  defaultTier: "free",
+  globalLimit: { maxRequests: 1e4, windowMs: 6e4 }
+};
+var DEFAULT_IP_RULES = {
+  allowlist: [],
+  blocklist: [],
+  mode: "blocklist"
+};
+var DEFAULT_API_KEYS = {
+  keys: []
+};
+
+// src/backend/services/FileLogWriter.ts
+function deriveLevel(statusCode) {
+  if (statusCode < 400) return "info";
+  if (statusCode < 500) return "warn";
+  if (statusCode === 503) return "fatal";
+  return "error";
+}
+function formatDate(date) {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+function formatTime(date) {
+  const h = String(date.getHours()).padStart(2, "0");
+  const min = String(date.getMinutes()).padStart(2, "0");
+  const s = String(date.getSeconds()).padStart(2, "0");
+  return `${h}${min}${s}`;
+}
+var FileLogWriter = class {
+  logDir;
+  appName;
+  maxLines;
+  currentDate;
+  currentLines = 0;
+  fileIndex = 0;
+  currentFilePath = null;
+  destroyed = false;
+  constructor(config) {
+    this.logDir = config.logDir;
+    this.appName = config.appName;
+    this.maxLines = config.maxLinesPerFile ?? DEFAULT_LOG_MAX_LINES;
+    this.currentDate = formatDate(/* @__PURE__ */ new Date());
+    try {
+      (0, import_fs.mkdirSync)(this.logDir, { recursive: true });
+    } catch (err) {
+      process.stderr.write(`[FileLogWriter] Failed to create log directory: ${err}
+`);
+    }
+    this.fileIndex = this.scanExistingFiles(this.currentDate);
+    this.rotateFile();
+  }
+  write(log) {
+    if (this.destroyed) return;
+    const now = new Date(log.timestamp);
+    const today = formatDate(now);
+    if (today !== this.currentDate) {
+      this.currentDate = today;
+      this.fileIndex = 1;
+      this.currentLines = 0;
+      this.rotateFile();
+    }
+    if (this.currentLines >= this.maxLines) {
+      this.fileIndex++;
+      this.currentLines = 0;
+      this.rotateFile();
+    }
+    const entry = {
+      timestamp: now.toISOString(),
+      level: deriveLevel(log.statusCode),
+      service: this.appName,
+      method: log.method,
+      path: log.path,
+      statusCode: log.statusCode,
+      responseTime: log.responseTime,
+      requestId: (0, import_crypto.randomUUID)(),
+      clientId: log.clientId,
+      ip: log.ip,
+      authenticated: log.authenticated
+    };
+    try {
+      (0, import_fs.appendFileSync)(this.currentFilePath, JSON.stringify(entry) + "\n");
+      this.currentLines++;
+    } catch (err) {
+      process.stderr.write(`[FileLogWriter] Write error: ${err}
+`);
+    }
+  }
+  destroy() {
+    this.destroyed = true;
+    this.currentFilePath = null;
+  }
+  /** Scan existing log files for a date to determine the next incremental number. */
+  scanExistingFiles(date) {
+    try {
+      const prefix = `${this.appName}_${date}_`;
+      const files = (0, import_fs.readdirSync)(this.logDir).filter(
+        (f) => f.startsWith(prefix) && f.endsWith(".log")
+      );
+      if (files.length === 0) return 1;
+      let maxIndex = 0;
+      for (const f of files) {
+        const parts = f.replace(".log", "").split("_");
+        const idx = parseInt(parts[parts.length - 1], 10);
+        if (!isNaN(idx) && idx > maxIndex) maxIndex = idx;
+      }
+      return maxIndex + 1;
+    } catch {
+      return 1;
+    }
+  }
+  rotateFile() {
+    const time = formatTime(/* @__PURE__ */ new Date());
+    const idx = String(this.fileIndex).padStart(3, "0");
+    const filename = `${this.appName}_${this.currentDate}_${time}_${idx}.log`;
+    this.currentFilePath = (0, import_path.join)(this.logDir, filename);
+  }
+};
+
 // src/backend/services/AnalyticsService.ts
 var MAX_LOG_SIZE = 1e4;
 var ACTIVE_WINDOW_MS = 3e5;
@@ -183,6 +318,12 @@ var AnalyticsService = class {
   logs = [];
   head = 0;
   count = 0;
+  fileLogWriter = null;
+  constructor(logConfig) {
+    if (logConfig) {
+      this.fileLogWriter = new FileLogWriter(logConfig);
+    }
+  }
   addLog(log) {
     if (this.count < MAX_LOG_SIZE) {
       this.logs.push(log);
@@ -191,6 +332,11 @@ var AnalyticsService = class {
       this.logs[this.head] = log;
       this.head = (this.head + 1) % MAX_LOG_SIZE;
     }
+    this.fileLogWriter?.write(log);
+  }
+  destroy() {
+    this.fileLogWriter?.destroy();
+    this.fileLogWriter = null;
   }
   getRecentLogs(limit = 20, offset = 0) {
     const ordered = this.getOrderedLogs();
@@ -243,17 +389,17 @@ var AnalyticsService = class {
 };
 
 // src/backend/services/DeviceRegistryService.ts
-var import_fs = __toESM(require("fs"));
-var import_path = __toESM(require("path"));
+var import_fs2 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
 
 // src/backend/utils/totp.ts
-var import_crypto = __toESM(require("crypto"));
+var import_crypto2 = __toESM(require("crypto"));
 var TIME_WINDOW_MS = 3600 * 1e3;
 var CODE_LENGTH = 16;
 function generateTOTP(browserId, secret, timeOffset = 0) {
   const timeWindow = Math.floor(Date.now() / TIME_WINDOW_MS) + timeOffset;
   const message = `${browserId}:${timeWindow}`;
-  const hmac = import_crypto.default.createHmac("sha256", secret).update(message).digest("hex");
+  const hmac = import_crypto2.default.createHmac("sha256", secret).update(message).digest("hex");
   return hmac.substring(0, CODE_LENGTH);
 }
 function validateTOTP(browserId, secret, providedCode) {
@@ -265,7 +411,7 @@ function timingSafeEqual(a, b) {
   if (a.length !== b.length) return false;
   const bufA = Buffer.from(a);
   const bufB = Buffer.from(b);
-  return import_crypto.default.timingSafeEqual(bufA, bufB);
+  return import_crypto2.default.timingSafeEqual(bufA, bufB);
 }
 function formatKey(browserId, code) {
   return `totp_${browserId}_${code}`;
@@ -280,7 +426,7 @@ function parseKey(key) {
   return { browserId, code };
 }
 function generateSecret() {
-  return import_crypto.default.randomBytes(32).toString("hex");
+  return import_crypto2.default.randomBytes(32).toString("hex");
 }
 
 // src/backend/services/DeviceRegistryService.ts
@@ -305,17 +451,17 @@ var DeviceRegistryService = class {
   }
   loadFromDisk() {
     try {
-      if (import_fs.default.existsSync(this.filePath)) {
-        const raw = import_fs.default.readFileSync(this.filePath, "utf-8");
+      if (import_fs2.default.existsSync(this.filePath)) {
+        const raw = import_fs2.default.readFileSync(this.filePath, "utf-8");
         const data = JSON.parse(raw);
         for (const device of data.devices) {
           this.devices.set(device.browserId, device);
         }
         console.log(`[DeviceRegistry] Loaded ${this.devices.size} devices from ${this.filePath}`);
       } else {
-        const dir = import_path.default.dirname(this.filePath);
-        if (!import_fs.default.existsSync(dir)) {
-          import_fs.default.mkdirSync(dir, { recursive: true });
+        const dir = import_path2.default.dirname(this.filePath);
+        if (!import_fs2.default.existsSync(dir)) {
+          import_fs2.default.mkdirSync(dir, { recursive: true });
         }
         this.saveToDiskSync();
         console.log(`[DeviceRegistry] Created new devices file at ${this.filePath}`);
@@ -328,7 +474,7 @@ var DeviceRegistryService = class {
     const data = {
       devices: Array.from(this.devices.values())
     };
-    import_fs.default.writeFileSync(this.filePath, JSON.stringify(data, null, 2), "utf-8");
+    import_fs2.default.writeFileSync(this.filePath, JSON.stringify(data, null, 2), "utf-8");
   }
   debouncedSave() {
     if (this.writeTimeout) clearTimeout(this.writeTimeout);
@@ -462,25 +608,6 @@ var DeviceRegistryService = class {
   }
 };
 
-// src/config/defaults.ts
-var DEFAULT_RATE_LIMIT_CONFIG = {
-  tiers: {
-    free: { algorithm: "tokenBucket", maxRequests: 100, windowMs: 6e4, refillRate: 10 },
-    pro: { algorithm: "slidingWindow", maxRequests: 1e3, windowMs: 6e4 },
-    unlimited: { algorithm: "none" }
-  },
-  defaultTier: "free",
-  globalLimit: { maxRequests: 1e4, windowMs: 6e4 }
-};
-var DEFAULT_IP_RULES = {
-  allowlist: [],
-  blocklist: [],
-  mode: "blocklist"
-};
-var DEFAULT_API_KEYS = {
-  keys: []
-};
-
 // src/backend/middleware/apiKeyAuth.ts
 function createApiKeyAuth(getKeys, deviceRegistry) {
   return function apiKeyAuth(req, res, next) {
@@ -599,10 +726,11 @@ function createGatewayMiddleware(userConfig) {
     rateLimits: userConfig?.rateLimits ?? DEFAULT_RATE_LIMIT_CONFIG,
     ipRules: userConfig?.ipRules ?? DEFAULT_IP_RULES,
     apiKeys: userConfig?.apiKeys ?? DEFAULT_API_KEYS,
-    deviceRegistryPath: userConfig?.deviceRegistryPath ?? ""
+    deviceRegistryPath: userConfig?.deviceRegistryPath ?? "",
+    logConfig: userConfig?.logConfig
   };
   const rateLimiterService = new RateLimiterService(config.rateLimits);
-  const analyticsService = new AnalyticsService();
+  const analyticsService = new AnalyticsService(userConfig?.logConfig);
   let deviceRegistry;
   if (config.deviceRegistryPath) {
     deviceRegistry = new DeviceRegistryService(config.deviceRegistryPath);
@@ -623,7 +751,7 @@ function createGatewayMiddleware(userConfig) {
 
 // src/backend/routes/gateway.ts
 var import_express2 = require("express");
-var import_crypto2 = __toESM(require("crypto"));
+var import_crypto3 = __toESM(require("crypto"));
 function createGatewayRoutes(options) {
   const { rateLimiterService, analyticsService, config } = options;
   const router = (0, import_express2.Router)();
@@ -666,7 +794,7 @@ function createGatewayRoutes(options) {
     }
     const newKey = {
       id: `key_${String(config.apiKeys.keys.length + 1).padStart(3, "0")}`,
-      key: `gw_live_${import_crypto2.default.randomBytes(16).toString("hex")}`,
+      key: `gw_live_${import_crypto3.default.randomBytes(16).toString("hex")}`,
       name,
       tier: tier || "free",
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -755,6 +883,7 @@ function createDeviceAuthRoutes(options) {
 0 && (module.exports = {
   AnalyticsService,
   DeviceRegistryService,
+  FileLogWriter,
   RateLimiterService,
   createApiKeyAuth,
   createDeviceAuthRoutes,