ninja-reverse-proxy 1.0.4 → 1.0.6

package/dist/observability/index.d.ts

@@ -0,0 +1,12 @@
+export { logger, writeAccessLog } from './logger/logger.js';
+export type { LogLevel, LoggerConfig } from './logger/logger.js';
+export { MetricsRegistry } from './metrics/prometheus.exporter.js';
+export { collectSystemMetrics, systemMetricsToPrometheus } from './metrics/system.metrics.js';
+export type { SystemMetrics } from './metrics/system.metrics.js';
+export { histogramRegistry, HistogramRegistry, Histogram } from './metrics/histogram.registry.js';
+export type { HistogramBucket } from './metrics/histogram.registry.js';
+export { tracer } from './tracing/tracer.js';
+export type { Span } from './tracing/tracer.js';
+export { readinessProbe, ReadinessProbe } from './health/readiness.js';
+export type { ReadinessCheck } from './health/readiness.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAClG,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,8 @@
+// Observability barrel — import anything observability-related from here
+export { logger, writeAccessLog } from './logger/logger.js';
+export { MetricsRegistry } from './metrics/prometheus.exporter.js';
+export { collectSystemMetrics, systemMetricsToPrometheus } from './metrics/system.metrics.js';
+export { histogramRegistry, HistogramRegistry, Histogram } from './metrics/histogram.registry.js';
+export { tracer } from './tracing/tracer.js';
+export { readinessProbe, ReadinessProbe } from './health/readiness.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAGlG,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/observability/logger/logger.d.ts

@@ -0,0 +1,19 @@
+export type LogLevel = "INFO" | "WARN" | "ERROR";
+export interface LoggerConfig {
+    eventLogPath?: string | undefined;
+    minLevel?: LogLevel | undefined;
+}
+export declare class Logger {
+    private eventLogPath?;
+    private minLevel;
+    configure(config: LoggerConfig): void;
+    info(source: string, message: string, meta?: Record<string, unknown>): void;
+    warn(source: string, message: string, meta?: Record<string, unknown>): void;
+    error(source: string, message: string, meta?: Record<string, unknown>): void;
+    writeAccessLog(logPath: string | undefined, clientIp: string, method: string, url: string, statusCode: number, bytesSent: number, latencyMs: number, userAgent: string): Promise<void>;
+    private _emit;
+    private _appendFile;
+}
+export declare const logger: Logger;
+export declare function writeAccessLog(logPath: string | undefined, clientIp: string, method: string, url: string, statusCode: number, bytesSent: number, latencyMs: number, userAgent: string): Promise<void>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/observability/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/observability/logger/logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACjC;AAcD,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAoB;IAEpC,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IASrC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3E,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAItE,cAAc,CAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAehB,OAAO,CAAC,KAAK;YA4BC,WAAW;CAQ1B;AAED,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/observability/logger/logger.js

@@ -0,0 +1,83 @@
+import { promises as fs } from "fs";
+import path from "path";
+const LEVEL_RANK = { INFO: 0, WARN: 1, ERROR: 2 };
+const isTTY = process.stdout.isTTY;
+const C = isTTY
+    ? {
+        INFO: "\x1b[36m",
+        WARN: "\x1b[33m",
+        ERROR: "\x1b[31m",
+        reset: "\x1b[0m",
+        dim: "\x1b[2m",
+    }
+    : { INFO: "", WARN: "", ERROR: "", reset: "", dim: "" };
+export class Logger {
+    eventLogPath;
+    minLevel = "INFO";
+    configure(config) {
+        if (config.eventLogPath !== undefined) {
+            this.eventLogPath = config.eventLogPath;
+        }
+        if (config.minLevel !== undefined) {
+            this.minLevel = config.minLevel;
+        }
+    }
+    info(source, message, meta) {
+        this._emit("INFO", source, message, meta);
+    }
+    warn(source, message, meta) {
+        this._emit("WARN", source, message, meta);
+    }
+    error(source, message, meta) {
+        this._emit("ERROR", source, message, meta);
+    }
+    async writeAccessLog(logPath, clientIp, method, url, statusCode, bytesSent, latencyMs, userAgent) {
+        if (!logPath)
+            return;
+        const timestamp = new Date().toISOString();
+        const line = `${clientIp} - - [${timestamp}] "${method} ${url} HTTP/1.1" ` +
+            `${statusCode} ${bytesSent} "-" "${userAgent}" ${latencyMs.toFixed(2)}ms\n`;
+        try {
+            const fullPath = path.resolve(logPath);
+            await fs.mkdir(path.dirname(fullPath), { recursive: true });
+            await fs.appendFile(fullPath, line, "utf8");
+        }
+        catch (err) {
+            this._emit("ERROR", "Logger", `Failed to write access log: ${err.message}`);
+        }
+    }
+    _emit(level, source, message, meta) {
+        if (LEVEL_RANK[level] < LEVEL_RANK[this.minLevel])
+            return;
+        const ts = new Date().toISOString();
+        const lvl = level.padEnd(5);
+        const metaStr = meta && Object.keys(meta).length > 0 ? " " + JSON.stringify(meta) : "";
+        const termLine = `${C.dim}[${ts}]${C.reset} ${C[level]}[${lvl}]${C.reset}` +
+            ` ${C[level]}[${source}]${C.reset} ${message}${metaStr}`;
+        if (level === "ERROR") {
+            process.stderr.write(termLine + "\n");
+        }
+        else {
+            process.stdout.write(termLine + "\n");
+        }
+        if (this.eventLogPath) {
+            const fileLine = `[${ts}] [${lvl}] [${source}] ${message}${metaStr}\n`;
+            void this._appendFile(fileLine);
+        }
+    }
+    async _appendFile(line) {
+        if (!this.eventLogPath)
+            return;
+        try {
+            const fullPath = path.resolve(this.eventLogPath);
+            await fs.mkdir(path.dirname(fullPath), { recursive: true });
+            await fs.appendFile(fullPath, line, "utf8");
+        }
+        catch { }
+    }
+}
+export const logger = new Logger();
+export async function writeAccessLog(logPath, clientIp, method, url, statusCode, bytesSent, latencyMs, userAgent) {
+    return logger.writeAccessLog(logPath, clientIp, method, url, statusCode, bytesSent, latencyMs, userAgent);
+}
+//# sourceMappingURL=logger.js.map

package/dist/observability/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/observability/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,MAAM,UAAU,GAA6B,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AACnC,MAAM,CAAC,GAA+C,KAAK;IACzD,CAAC,CAAC;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;KACf;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AAE1D,MAAM,OAAO,MAAM;IACT,YAAY,CAAU;IACtB,QAAQ,GAAa,MAAM,CAAC;IAEpC,SAAS,CAAC,MAAoB;QAC5B,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAC,CAAC;YACrC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAC1C,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAC,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,IAA8B;QAClE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,IAA8B;QAClE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,OAAe,EAAE,IAA8B;QACnE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,OAA2B,EAC3B,QAAgB,EAChB,MAAc,EACd,GAAW,EACX,UAAkB,EAClB,SAAiB,EACjB,SAAiB,EACjB,SAAiB;QAEjB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GACR,GAAG,QAAQ,SAAS,SAAS,MAAM,MAAM,IAAI,GAAG,aAAa;YAC7D,GAAG,UAAU,IAAI,SAAS,SAAS,SAAS,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAQ,EAAC,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAEO,KAAK,CACX,KAAe,EACf,MAAc,EACd,OAAe,EACf,IAA8B;QAE9B,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QAE1D,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,OAAO,GACX,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,QAAQ,GACZ,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,EAAE;YACzD,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QAE3D,IAAI,KAAK,KAAK,OAAO,EAAC,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,KAAK,OAAO,GAAG,OAAO,IAAI,CAAC;YACvE,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAY;QACpC,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B,EAC3B,QAAgB,EAChB,MAAc,EACd,GAAW,EACX,UAAkB,EAClB,SAAiB,EACjB,SAAiB,EACjB,SAAiB;IAEjB,OAAO,MAAM,CAAC,cAAc,CAC1B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,GAAG,EACH,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/observability/logger/tenant-log.streamer.d.ts

@@ -0,0 +1,29 @@
+export interface TenantLogEntry {
+    timestamp: string;
+    clientIp: string;
+    method: string;
+    url: string;
+    statusCode: number;
+    bytesSent: number;
+    latencyMs: number;
+    userAgent: string;
+}
+export declare class TenantLogStreamer {
+    private queue;
+    private endpoints;
+    private intervalId;
+    private globalSize;
+    private readonly MAX_TENANT_QUEUE;
+    private readonly MAX_GLOBAL_QUEUE;
+    configure(endpoints: {
+        tenantId: string;
+        destination: string;
+    }[]): void;
+    queueLog(tenantId: string, log: TenantLogEntry): void;
+    start(): void;
+    stop(): void;
+    flush(): Promise<void>;
+    private sendLogs;
+}
+export declare const tenantLogStreamer: TenantLogStreamer;
+//# sourceMappingURL=tenant-log.streamer.d.ts.map

package/dist/observability/logger/tenant-log.streamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-log.streamer.d.ts","sourceRoot":"","sources":["../../../src/observability/logger/tenant-log.streamer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAEnC,SAAS,CAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE;IAQhE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc;IAgB9C,KAAK;IAML,IAAI;IAOE,KAAK;YAoBJ,QAAQ;CAiBvB;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/observability/logger/tenant-log.streamer.js

@@ -0,0 +1,80 @@
+import { logger } from "./logger.js";
+export class TenantLogStreamer {
+    queue = new Map();
+    endpoints = new Map(); // tenantId -> destination URL
+    intervalId = null;
+    globalSize = 0;
+    MAX_TENANT_QUEUE = 10000;
+    MAX_GLOBAL_QUEUE = 50000;
+    configure(endpoints) {
+        this.endpoints.clear();
+        for (const ep of endpoints) {
+            this.endpoints.set(ep.tenantId, ep.destination);
+        }
+        this.start();
+    }
+    queueLog(tenantId, log) {
+        if (!this.endpoints.has(tenantId))
+            return; // Drop unmapped traffic immediately
+        if (this.globalSize >= this.MAX_GLOBAL_QUEUE)
+            return;
+        let tenantQueue = this.queue.get(tenantId);
+        if (!tenantQueue) {
+            tenantQueue = [];
+            this.queue.set(tenantId, tenantQueue);
+        }
+        if (tenantQueue.length >= this.MAX_TENANT_QUEUE)
+            return;
+        tenantQueue.push(log);
+        this.globalSize++;
+    }
+    start() {
+        if (this.intervalId !== null)
+            return;
+        this.intervalId = setInterval(() => this.flush(), 1000);
+        this.intervalId.unref();
+    }
+    stop() {
+        if (this.intervalId !== null) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+    }
+    async flush() {
+        if (this.globalSize === 0)
+            return;
+        for (const [tenantId, entries] of this.queue.entries()) {
+            if (entries.length === 0)
+                continue;
+            const destination = this.endpoints.get(tenantId);
+            if (!destination) {
+                this.globalSize -= entries.length;
+                this.queue.set(tenantId, []);
+                continue;
+            }
+            const batch = entries.splice(0, entries.length);
+            this.globalSize -= batch.length;
+            await this.sendLogs(tenantId, destination, batch);
+        }
+    }
+    async sendLogs(tenantId, destination, logs) {
+        try {
+            const response = await fetch(destination, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-Tenant-ID": tenantId,
+                },
+                body: JSON.stringify({ tenantId, logs }),
+            });
+            if (!response.ok) {
+                logger.warn(`TenantLogStreamer:${process.pid}`, `Webhook response failed for tenant ${tenantId}: ${response.statusText}`);
+            }
+        }
+        catch (err) {
+            logger.error(`TenantLogStreamer:${process.pid}`, `Failed to dispatch logs to tenant ${tenantId} webhook: ${err.message}`);
+        }
+    }
+}
+export const tenantLogStreamer = new TenantLogStreamer();
+//# sourceMappingURL=tenant-log.streamer.js.map

package/dist/observability/logger/tenant-log.streamer.js.map

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

package/dist/observability/metrics/histogram.registry.d.ts

@@ -0,0 +1,43 @@
+export interface HistogramBucket {
+    le: number;
+    count: number;
+}
+export declare class Histogram {
+    private buckets;
+    private sum;
+    private count;
+    constructor(boundaries: number[]);
+    observe(value: number): void;
+    toPrometheus(name: string, labels: string): string;
+    getSnapshot(): {
+        buckets: {
+            le: number;
+            count: number;
+        }[];
+        sum: number;
+        count: number;
+    };
+    merge(other: {
+        buckets: HistogramBucket[];
+        sum: number;
+        count: number;
+    }): void;
+}
+export declare class HistogramRegistry {
+    private histograms;
+    /**
+     * Get or create a histogram by a unique name (typically includes labels).
+     * Default boundaries are suitable for millisecond latency tracking.
+     */
+    getOrCreate(name: string, boundaries?: number[]): Histogram;
+    /**
+     * Emit all histograms whose key starts with `prefix` as Prometheus text.
+     * The key format is expected to be "<prefix>:<labels>".
+     * Produces _bucket, _sum, _count lines for each entry.
+     */
+    toPrometheusAll(prefix: string): string;
+    getSnapshotAll(): Record<string, any>;
+    mergeAll(snapshots: Record<string, any>): void;
+}
+export declare const histogramRegistry: HistogramRegistry;
+//# sourceMappingURL=histogram.registry.d.ts.map

package/dist/observability/metrics/histogram.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.registry.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics/histogram.registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,KAAK,CAAK;gBAEN,UAAU,EAAE,MAAM,EAAE;IAGhC,OAAO,CAAC,KAAK,EAAE,MAAM;IAOrB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAWlD,WAAW;;;;;;;;IAQX,KAAK,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAWxE;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAgC;IAElD;;;OAGG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,UAAU,WAAmD,GAC5D,SAAS;IAOZ;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAUvC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMxC;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/observability/metrics/histogram.registry.js

@@ -0,0 +1,87 @@
+export class Histogram {
+    buckets;
+    sum = 0;
+    count = 0;
+    constructor(boundaries) {
+        this.buckets = [...boundaries.map(le => ({ le, count: 0 })), { le: Infinity, count: 0 }];
+    }
+    observe(value) {
+        this.sum += value;
+        this.count++;
+        for (const b of this.buckets) {
+            if (value <= b.le)
+                b.count++;
+        }
+    }
+    toPrometheus(name, labels) {
+        let out = '';
+        for (const b of this.buckets) {
+            const le = b.le === Infinity ? '+Inf' : String(b.le);
+            out += `${name}_bucket{${labels},le="${le}"} ${b.count}\n`;
+        }
+        out += `${name}_sum{${labels}} ${this.sum}\n`;
+        out += `${name}_count{${labels}} ${this.count}\n`;
+        return out;
+    }
+    getSnapshot() {
+        return {
+            buckets: this.buckets.map(b => ({ le: b.le, count: b.count })),
+            sum: this.sum,
+            count: this.count,
+        };
+    }
+    merge(other) {
+        this.sum += other.sum;
+        this.count += other.count;
+        for (let i = 0; i < this.buckets.length; i++) {
+            const b = this.buckets[i];
+            const ob = other.buckets[i];
+            if (ob) {
+                b.count += ob.count;
+            }
+        }
+    }
+}
+export class HistogramRegistry {
+    histograms = new Map();
+    /**
+     * Get or create a histogram by a unique name (typically includes labels).
+     * Default boundaries are suitable for millisecond latency tracking.
+     */
+    getOrCreate(name, boundaries = [5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000]) {
+        if (!this.histograms.has(name)) {
+            this.histograms.set(name, new Histogram(boundaries));
+        }
+        return this.histograms.get(name);
+    }
+    /**
+     * Emit all histograms whose key starts with `prefix` as Prometheus text.
+     * The key format is expected to be "<prefix>:<labels>".
+     * Produces _bucket, _sum, _count lines for each entry.
+     */
+    toPrometheusAll(prefix) {
+        let out = '';
+        for (const [key, histogram] of this.histograms.entries()) {
+            if (!key.startsWith(`${prefix}:`))
+                continue;
+            const labels = key.slice(prefix.length + 1);
+            out += histogram.toPrometheus(prefix, labels);
+        }
+        return out;
+    }
+    getSnapshotAll() {
+        const snapshots = {};
+        for (const [key, histogram] of this.histograms.entries()) {
+            snapshots[key] = histogram.getSnapshot();
+        }
+        return snapshots;
+    }
+    mergeAll(snapshots) {
+        for (const [key, snap] of Object.entries(snapshots)) {
+            const hist = this.getOrCreate(key);
+            hist.merge(snap);
+        }
+    }
+}
+export const histogramRegistry = new HistogramRegistry();
+//# sourceMappingURL=histogram.registry.js.map

package/dist/observability/metrics/histogram.registry.js.map

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

package/dist/observability/metrics/prometheus.exporter.d.ts

@@ -0,0 +1,19 @@
+export declare class MetricsRegistry {
+    private requestsTotal;
+    private activeConnections;
+    private cacheOperations;
+    private healthyUpstreams;
+    constructor(healthyUpstreams: Set<string>);
+    recordRequest(method: string, path: string, status: number, upstreamId: string, durationMs: number, tenantId?: string): void;
+    recordActiveConnection(upstreamId: string, delta: number): void;
+    recordCacheOp(action: "hit" | "miss"): void;
+    getSnapshot(): {
+        requestsTotal: [string, number][];
+        activeConnections: [string, number][];
+        cacheOperations: [string, number][];
+        histograms: Record<string, any>;
+    };
+    mergeSnapshot(snap: any): void;
+    getExpositionFormat(allUpstreamIds: string[], tenantFilter?: string): string;
+}
+//# sourceMappingURL=prometheus.exporter.d.ts.map

package/dist/observability/metrics/prometheus.exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.exporter.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics/prometheus.exporter.ts"],"names":[],"mappings":"AAGA,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,gBAAgB,CAAc;gBAE1B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC;IAGlC,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAS;IAUZ,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAIxD,aAAa,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM;IAMpC,WAAW;;;;;;IAQX,aAAa,CAAC,IAAI,EAAE,GAAG;IAqBvB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;CAgDpF"}

package/dist/observability/metrics/prometheus.exporter.js

@@ -0,0 +1,107 @@
+import { collectSystemMetrics, systemMetricsToPrometheus } from './system.metrics.js';
+import { histogramRegistry } from './histogram.registry.js';
+export class MetricsRegistry {
+    requestsTotal = new Map();
+    activeConnections = new Map();
+    cacheOperations = new Map();
+    healthyUpstreams;
+    constructor(healthyUpstreams) {
+        this.healthyUpstreams = healthyUpstreams;
+    }
+    recordRequest(method, path, status, upstreamId, durationMs, tenantId = "none") {
+        const cleanPath = path.split("?")[0];
+        const labels = `method="${method}",path="${cleanPath}",status="${status}",upstream_id="${upstreamId}",tenant_id="${tenantId}"`;
+        this.requestsTotal.set(labels, (this.requestsTotal.get(labels) || 0) + 1);
+        const histogramLabel = `method="${method}",path="${cleanPath}",upstream_id="${upstreamId}",tenant_id="${tenantId}"`;
+        histogramRegistry
+            .getOrCreate(`ninja_http_request_duration_ms:${histogramLabel}`)
+            .observe(durationMs);
+    }
+    recordActiveConnection(upstreamId, delta) {
+        const current = this.activeConnections.get(upstreamId) || 0;
+        this.activeConnections.set(upstreamId, Math.max(0, current + delta));
+    }
+    recordCacheOp(action) {
+        this.cacheOperations.set(action, (this.cacheOperations.get(action) || 0) + 1);
+    }
+    getSnapshot() {
+        return {
+            requestsTotal: Array.from(this.requestsTotal.entries()),
+            activeConnections: Array.from(this.activeConnections.entries()),
+            cacheOperations: Array.from(this.cacheOperations.entries()),
+            histograms: histogramRegistry.getSnapshotAll(),
+        };
+    }
+    mergeSnapshot(snap) {
+        if (!snap)
+            return;
+        if (snap.requestsTotal) {
+            for (const [labels, count] of snap.requestsTotal) {
+                this.requestsTotal.set(labels, (this.requestsTotal.get(labels) || 0) + count);
+            }
+        }
+        if (snap.activeConnections) {
+            for (const [upstreamId, count] of snap.activeConnections) {
+                this.activeConnections.set(upstreamId, (this.activeConnections.get(upstreamId) || 0) + count);
+            }
+        }
+        if (snap.cacheOperations) {
+            for (const [action, count] of snap.cacheOperations) {
+                this.cacheOperations.set(action, (this.cacheOperations.get(action) || 0) + count);
+            }
+        }
+        if (snap.histograms) {
+            histogramRegistry.mergeAll(snap.histograms);
+        }
+    }
+    getExpositionFormat(allUpstreamIds, tenantFilter) {
+        let rawOutput = "";
+        rawOutput += "# HELP ninja_http_requests_total Total number of HTTP requests processed by the proxy\n";
+        rawOutput += "# TYPE ninja_http_requests_total counter\n";
+        for (const [labels, count] of this.requestsTotal.entries()) {
+            rawOutput += `ninja_http_requests_total{${labels}} ${count}\n`;
+        }
+        rawOutput += "\n";
+        rawOutput += "# HELP ninja_http_request_duration_ms Request duration in milliseconds\n";
+        rawOutput += "# TYPE ninja_http_request_duration_ms histogram\n";
+        rawOutput += histogramRegistry.toPrometheusAll("ninja_http_request_duration_ms");
+        rawOutput += "\n";
+        rawOutput += "# HELP ninja_active_connections Current number of active connections to the upstream\n";
+        rawOutput += "# TYPE ninja_active_connections gauge\n";
+        for (const upstreamId of allUpstreamIds) {
+            const active = this.activeConnections.get(upstreamId) || 0;
+            rawOutput += `ninja_active_connections{upstream_id="${upstreamId}"} ${active}\n`;
+        }
+        rawOutput += "\n";
+        rawOutput += "# HELP ninja_cache_operations_total Total cache hits/misses\n";
+        rawOutput += "# TYPE ninja_cache_operations_total counter\n";
+        rawOutput += `ninja_cache_operations_total{action="hit"} ${this.cacheOperations.get("hit") || 0}\n`;
+        rawOutput += `ninja_cache_operations_total{action="miss"} ${this.cacheOperations.get("miss") || 0}\n`;
+        rawOutput += "\n";
+        rawOutput += "# HELP ninja_upstream_status Health status of the upstream (1 = UP, 0 = DOWN)\n";
+        rawOutput += "# TYPE ninja_upstream_status gauge\n";
+        for (const upstreamId of allUpstreamIds) {
+            const isUp = this.healthyUpstreams.has(upstreamId) ? 1 : 0;
+            rawOutput += `ninja_upstream_status{upstream_id="${upstreamId}"} ${isUp}\n`;
+        }
+        rawOutput += "\n";
+        rawOutput += "# HELP ninja_system_metrics System-level resource metrics\n";
+        rawOutput += "# TYPE ninja_system_metrics gauge\n";
+        rawOutput += systemMetricsToPrometheus(collectSystemMetrics());
+        if (!tenantFilter) {
+            return rawOutput;
+        }
+        const lines = rawOutput.split("\n");
+        const filteredLines = lines.filter((line) => {
+            if (line.startsWith("#") || !line.trim())
+                return true;
+            const match = line.match(/tenant_id="([^"]+)"/);
+            if (match) {
+                return match[1] === tenantFilter;
+            }
+            return true;
+        });
+        return filteredLines.join("\n");
+    }
+}
+//# sourceMappingURL=prometheus.exporter.js.map

package/dist/observability/metrics/prometheus.exporter.js.map

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

package/dist/observability/metrics/system.metrics.d.ts

@@ -0,0 +1,10 @@
+export interface SystemMetrics {
+    cpuUsage: number;
+    memUsedMb: number;
+    memTotalMb: number;
+    loadAvg1m: number;
+    uptime: number;
+}
+export declare function collectSystemMetrics(): SystemMetrics;
+export declare function systemMetricsToPrometheus(metrics: SystemMetrics): string;
+//# sourceMappingURL=system.metrics.d.ts.map

package/dist/observability/metrics/system.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.metrics.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics/system.metrics.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,IAAI,aAAa,CASpD;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAOxE"}

package/dist/observability/metrics/system.metrics.js

@@ -0,0 +1,20 @@
+import os from 'os';
+export function collectSystemMetrics() {
+    const memUsed = process.memoryUsage();
+    return {
+        cpuUsage: os.loadavg()[0] ?? 0,
+        memUsedMb: Math.round(memUsed.rss / 1024 / 1024),
+        memTotalMb: Math.round(os.totalmem() / 1024 / 1024),
+        loadAvg1m: os.loadavg()[0] ?? 0,
+        uptime: process.uptime(),
+    };
+}
+export function systemMetricsToPrometheus(metrics) {
+    return [
+        `ninja_proxy_cpu_load ${metrics.cpuUsage}`,
+        `ninja_proxy_memory_used_mb ${metrics.memUsedMb}`,
+        `ninja_proxy_memory_total_mb ${metrics.memTotalMb}`,
+        `ninja_proxy_uptime_seconds ${metrics.uptime}`,
+    ].join('\n') + '\n';
+}
+//# sourceMappingURL=system.metrics.js.map

package/dist/observability/metrics/system.metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.metrics.js","sourceRoot":"","sources":["../../../src/observability/metrics/system.metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAUpB,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO;QACL,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;QAChD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;QACnD,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAsB;IAC9D,OAAO;QACL,wBAAwB,OAAO,CAAC,QAAQ,EAAE;QAC1C,8BAA8B,OAAO,CAAC,SAAS,EAAE;QACjD,+BAA+B,OAAO,CAAC,UAAU,EAAE;QACnD,8BAA8B,OAAO,CAAC,MAAM,EAAE;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/observability/tracing/tracer.d.ts

@@ -0,0 +1,16 @@
+export interface Span {
+    traceId: string;
+    spanId: string;
+    name: string;
+    startMs: number;
+    endMs?: number;
+    attributes: Record<string, string>;
+}
+export declare class Tracer {
+    private spans;
+    startSpan(name: string, traceId: string, attributes?: Record<string, string>): Span;
+    endSpan(span: Span): void;
+    flush(): Span[];
+}
+export declare const tracer: Tracer;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/observability/tracing/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../src/observability/tracing/tracer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AACD,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAc;IAC3B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAWvF,OAAO,CAAC,IAAI,EAAE,IAAI;IAGlB,KAAK,IAAI,IAAI,EAAE;CAKhB;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}