4runr-os 2.10.39 → 2.10.41

package/apps/gateway/src/index.ts

@@ -72,7 +72,9 @@ import path from 'path';
 import { registerDevKitRoutes } from './devkit/routes.js';
 import { mfaRoutes } from './routes/mfa.js';
 import { gdprRoutes } from './routes/gdpr.js';
+import { registerMonitoringRoutes } from './routes/monitoring.js';
 import { ddosProtection } from './middleware/ddos-protection.js';
+import { wrapLoggerForMonitoring } from './middleware/log-capture.js';
 import { initializeDatabase, shutdownDatabase } from './db/init.js';
 import type { PrismaClient } from '@prisma/client';
 
@@ -86,7 +88,10 @@ if (persistenceMode === 'memory') {
 }
 
 // Create structured logger (will be updated per-request with correlation ID)
-const baseLogger = isMemoryMode ? memoryLogger : createLogger('Gateway');
+let baseLogger = isMemoryMode ? memoryLogger : createLogger('Gateway');
+
+// Wrap logger to capture logs for monitoring endpoints (Phase 0)
+baseLogger = wrapLoggerForMonitoring(baseLogger);
 
 const PORT = env.PORT;
 const HOST = env.HOST;
@@ -274,11 +279,16 @@ if (dbResult.client && persistenceMode !== 'memory') {
 
 // Health endpoint (liveness probe - no auth required)
 fastify.get('/health', async (request, reply) => {
-  healthCheckTotal.inc({ endpoint: '/health', status: '200' });
   const alive = isAlive();
   const { getMetricsSummary } = await import('./metrics/index.js');
   const summary = await getMetricsSummary();
   
+  const statusCode = alive ? 200 : 503;
+  reply.status(statusCode);
+  
+  // Track actual HTTP status (not just 200)
+  healthCheckTotal.inc({ endpoint: '/health', status: String(statusCode) });
+  
   return {
     ok: alive,
     status: alive ? 'alive' : 'dead',
@@ -368,16 +378,16 @@ fastify.get('/metrics', async (request, reply) => {
   const runQueue = getQueue();
   if (runQueue) {
     try {
+      // BullMQ v4+ getJobCounts: pass state names as separate args, returns exact keys
       const counts = await runQueue.getJobCounts(
-        'wait',
-        'paused',
-        'active',
-        'delayed',
         'waiting',
+        'active',
         'completed',
-        'failed'
+        'failed',
+        'delayed',
+        'paused'
       ) as Record<string, number>;
-      const waiting = counts['waiting'] ?? counts['wait'] ?? 0;
+      const waiting = counts['waiting'] ?? 0;
       const activeJobs = counts['active'] ?? 0;
       queueJobsWaiting.set({ queue: 'run-execution' }, waiting);
       queueJobsActive.set({ queue: 'run-execution' }, activeJobs);
@@ -420,6 +430,15 @@ fastify.get('/api/monitoring/summary', async (request, reply) => {
   };
 });
 
+// Register advanced monitoring routes (Phase 0)
+// SECURITY: In production, these require auth. For local dev (127.0.0.1), consider skipping auth.
+// Deployment guidance: use network policy to restrict access or enable requireAuth.
+const isLocalDev = HOST === '127.0.0.1' || HOST === 'localhost';
+registerMonitoringRoutes(fastify, {
+  requireAuth: isLocalDev ? false : requireAuth, // Explicitly false for local, function for prod
+  readRateLimit: readRateLimit,
+});
+
 // Apply DDoS protection globally (before other middleware)
 fastify.addHook('onRequest', ddosProtection);
 

package/apps/gateway/src/metrics/monitoring-detail.ts

@@ -0,0 +1,162 @@
+/**
+ * Phase 3: structured snapshots from prom-client metrics for /api/monitoring/metrics/*
+ * (no Prometheus text parsing — reads live registry values.)
+ */
+
+import {
+  httpRequestTotal,
+  httpRequestErrors,
+  runsCreated,
+  runsStarted,
+  runsCompleted,
+  runsActive,
+  sseConnectionsOpened,
+  sseConnectionsClosed,
+  sseActiveConnections,
+  sseMessagesTotal,
+  dbConnectionsActive,
+  dbConnectionsIdle,
+  redisConnectionsActive,
+} from './index.js';
+
+function sumCounterValues(m: { values: Array<{ value: number }> }): number {
+  return m.values.reduce((s, x) => s + x.value, 0);
+}
+
+function gaugeValue(m: { values: Array<{ value: number }> }): number {
+  return m.values[0]?.value ?? 0;
+}
+
+function isFailedRunStatus(status: string): boolean {
+  const normalized = status.trim().toLowerCase();
+  return [
+    'failed',
+    'failure',
+    'error',
+    'errored',
+    'cancelled',
+    'canceled',
+    'timeout',
+    'timed_out',
+  ].includes(normalized);
+}
+
+export async function getMonitoringHttpPayload(): Promise<Record<string, unknown>> {
+  const req = await httpRequestTotal.get();
+  let totalRequests = 0;
+  const byRoute: Array<{ method: string; route: string; status_code: string; count: number }> =
+    [];
+  for (const x of req.values) {
+    totalRequests += x.value;
+    byRoute.push({
+      method: String(x.labels.method ?? ''),
+      route: String(x.labels.route ?? ''),
+      status_code: String(x.labels.status_code ?? ''),
+      count: x.value,
+    });
+  }
+  byRoute.sort((a, b) => b.count - a.count);
+
+  const err = await httpRequestErrors.get();
+  let totalErrors = 0;
+  const errorsByRoute: Array<{
+    method: string;
+    route: string;
+    error_type: string;
+    count: number;
+  }> = [];
+  for (const x of err.values) {
+    totalErrors += x.value;
+    errorsByRoute.push({
+      method: String(x.labels.method ?? ''),
+      route: String(x.labels.route ?? ''),
+      error_type: String(x.labels.error_type ?? ''),
+      count: x.value,
+    });
+  }
+  errorsByRoute.sort((a, b) => b.count - a.count);
+
+  const errorRate = totalRequests > 0 ? totalErrors / totalRequests : 0;
+
+  return {
+    placeholder: false,
+    summary: {
+      totalRequests,
+      totalErrors,
+      errorRate: Number(errorRate.toFixed(4)),
+    },
+    topRoutes: byRoute.slice(0, 25),
+    errorsByRoute: errorsByRoute.slice(0, 15),
+    timestamp: new Date().toISOString(),
+  };
+}
+
+export async function getMonitoringRunsPayload(): Promise<Record<string, unknown>> {
+  const created = sumCounterValues(await runsCreated.get());
+  const started = sumCounterValues(await runsStarted.get());
+  const completedByStatus = (await runsCompleted.get()).values.map((x) => ({
+    status: String(x.labels.status ?? ''),
+    count: x.value,
+  }));
+  const completed = completedByStatus.reduce((s, x) => s + x.count, 0);
+  const failedByStatus = completedByStatus.filter((x) => isFailedRunStatus(x.status));
+  const active = gaugeValue(await runsActive.get());
+
+  return {
+    placeholder: false,
+    summary: {
+      created,
+      started,
+      completed,
+      failed: failedByStatus.reduce((s, x) => s + x.count, 0),
+      active,
+    },
+    byStatus: completedByStatus,
+    failedStatusLabels: failedByStatus.map((x) => x.status),
+    timestamp: new Date().toISOString(),
+  };
+}
+
+export async function getMonitoringSsePayload(): Promise<Record<string, unknown>> {
+  const opened = sumCounterValues(await sseConnectionsOpened.get());
+  const closed = sumCounterValues(await sseConnectionsClosed.get());
+  const active = gaugeValue(await sseActiveConnections.get());
+  const messages = sumCounterValues(await sseMessagesTotal.get());
+
+  return {
+    placeholder: false,
+    summary: {
+      connectionsOpened: opened,
+      connectionsClosed: closed,
+      activeConnections: active,
+      messagesSent: messages,
+    },
+    timestamp: new Date().toISOString(),
+  };
+}
+
+export async function getDependencyPoolsPayload(): Promise<{
+  database: { active: number; idle: number };
+  redis: { active: number };
+  telemetry: {
+    source: string;
+    bestEffort: boolean;
+    note: string;
+  };
+}> {
+  return {
+    database: {
+      active: gaugeValue(await dbConnectionsActive.get()),
+      idle: gaugeValue(await dbConnectionsIdle.get()),
+    },
+    redis: {
+      active: gaugeValue(await redisConnectionsActive.get()),
+    },
+    telemetry: {
+      source: 'prom-client connection gauges',
+      bestEffort: true,
+      note:
+        'Connection gauges are best-effort instrumentation; zeros can mean the gauges are not being updated, not necessarily that dependencies are disconnected.',
+    },
+  };
+}

package/apps/gateway/src/middleware/log-capture.ts

@@ -0,0 +1,70 @@
+/**
+ * Log capture middleware for monitoring log buffer
+ * Intercepts logger calls and feeds them to the monitoring log buffer
+ */
+
+import { addMonitoringLog } from '../routes/monitoring.js';
+
+/**
+ * Wrap a logger to capture log entries for monitoring
+ * Note: Uses duck typing to avoid strict type checks (compatible with both Logger and memoryLogger)
+ */
+export function wrapLoggerForMonitoring(logger: any): any {
+  // Skip if this doesn't look like a standard logger (e.g., memoryLogger)
+  if (!logger || typeof logger.info !== 'function') {
+    return logger;
+  }
+
+  const originalInfo = logger.info.bind(logger);
+  const originalWarn = logger.warn.bind(logger);
+  const originalError = logger.error.bind(logger);
+  const originalDebug = logger.debug?.bind(logger);
+
+  logger.info = (message: string, data?: Record<string, unknown>) => {
+    addMonitoringLog({
+      timestamp: new Date().toISOString(),
+      level: 'info',
+      message,
+      context: logger.context || 'Gateway',
+      ...(data && { data }),
+    });
+    return originalInfo(message, data);
+  };
+
+  logger.warn = (message: string, data?: Record<string, unknown>) => {
+    addMonitoringLog({
+      timestamp: new Date().toISOString(),
+      level: 'warn',
+      message,
+      context: logger.context || 'Gateway',
+      ...(data && { data }),
+    });
+    return originalWarn(message, data);
+  };
+
+  logger.error = (message: string, data?: Record<string, unknown>) => {
+    addMonitoringLog({
+      timestamp: new Date().toISOString(),
+      level: 'error',
+      message,
+      context: logger.context || 'Gateway',
+      ...(data && { data }),
+    });
+    return originalError(message, data);
+  };
+
+  if (originalDebug) {
+    logger.debug = (message: string, data?: Record<string, unknown>) => {
+      addMonitoringLog({
+        timestamp: new Date().toISOString(),
+        level: 'debug',
+        message,
+        context: logger.context || 'Gateway',
+        ...(data && { data }),
+      });
+      return originalDebug(message, data);
+    };
+  }
+
+  return logger;
+}

package/apps/gateway/src/routes/monitoring.ts

@@ -0,0 +1,298 @@
+/**
+ * Advanced monitoring routes for Portal Monitoring (Phase 0)
+ * Provides structured logs, dependency details, and extended metrics
+ * 
+ * SECURITY: All monitoring endpoints require authentication in production.
+ * For local development, consider network binding (127.0.0.1 only).
+ */
+
+import { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+import { getQueue } from '../queue/index.js';
+import { getRedisClient } from '../db/redis.js';
+import { getPrismaClient } from '../db/prisma.js';
+import { performHealthChecks } from '../health/index.js';
+import { createLogger } from '@4runr/shared';
+import {
+  getDependencyPoolsPayload,
+  getMonitoringHttpPayload,
+  getMonitoringRunsPayload,
+  getMonitoringSsePayload,
+} from '../metrics/monitoring-detail.js';
+
+const logger = createLogger('Gateway:Monitoring');
+
+interface LogEntry {
+  timestamp: string;
+  level: 'error' | 'warn' | 'info' | 'debug';
+  message: string;
+  context?: string;
+  data?: Record<string, unknown>;
+}
+
+// In-memory ring buffer for logs (last 1000 entries)
+const LOG_BUFFER_SIZE = 1000;
+const logBuffer: LogEntry[] = [];
+
+/**
+ * Add log entry to buffer (called by logger middleware or manually)
+ */
+export function addMonitoringLog(entry: LogEntry): void {
+  logBuffer.push(entry);
+  if (logBuffer.length > LOG_BUFFER_SIZE) {
+    logBuffer.shift();
+  }
+}
+
+/**
+ * Register monitoring routes
+ * @param fastify Fastify instance
+ * @param options Optional configuration for route security
+ */
+export function registerMonitoringRoutes(
+  fastify: FastifyInstance,
+  options?: {
+    requireAuth?: boolean | any; // boolean false or auth handler function
+    readRateLimit?: any;
+  }
+): void {
+  const { requireAuth, readRateLimit } = options || {};
+  
+  // Determine if auth is required (requireAuth can be false, function, or undefined)
+  const authHandler = requireAuth === false ? null : requireAuth;
+  const preHandler = authHandler && readRateLimit
+    ? [authHandler, readRateLimit]
+    : authHandler
+    ? [authHandler]
+    : [];
+
+  /**
+   * GET /api/monitoring/logs
+   * Returns last N Gateway logs for TUI display
+   * SECURITY: Requires authentication (contains operational data)
+   */
+  fastify.get('/api/monitoring/logs', {
+    ...(preHandler.length > 0 && { preHandler }),
+  }, async (request: FastifyRequest, reply: FastifyReply) => {
+    const query = request.query as { limit?: string; level?: string };
+    const limit = Math.min(parseInt(query.limit || '100', 10), LOG_BUFFER_SIZE);
+    const levelFilter = query.level as LogEntry['level'] | undefined;
+
+    let logs = logBuffer.slice(-limit);
+    
+    if (levelFilter) {
+      logs = logs.filter(log => log.level === levelFilter);
+    }
+
+    return {
+      logs,
+      count: logs.length,
+      bufferSize: logBuffer.length,
+      timestamp: new Date().toISOString(),
+    };
+  });
+
+  /**
+   * GET /api/monitoring/dependencies/detail
+   * Extended dependency info (connection pools, queue stats, etc.)
+   * SECURITY: Requires authentication (exposes infrastructure details)
+   */
+  fastify.get('/api/monitoring/dependencies/detail', {
+    ...(preHandler.length > 0 && { preHandler }),
+  }, async (request: FastifyRequest, reply: FastifyReply) => {
+    const health = await performHealthChecks();
+    const details: {
+      database?: {
+        status: string;
+        latency?: number;
+        poolAvailable?: boolean;
+        pool?: { active: number; idle: number };
+        telemetry?: { source: string; bestEffort: boolean; note: string };
+      };
+      redis?: {
+        status: string;
+        latency?: number;
+        connectionCountAvailable?: boolean;
+        connections?: { active: number };
+        telemetry?: { source: string; bestEffort: boolean; note: string };
+      };
+      queue?: {
+        status: string;
+        jobs?: {
+          waiting: number;
+          active: number;
+          completed: number;
+          failed: number;
+          delayed: number;
+        };
+      };
+    } = {};
+
+    const pools = await getDependencyPoolsPayload();
+
+    // Database details
+    if (health.checks.database) {
+      const dbLatency = health.checks.database.responseTime;
+      details.database = {
+        status: health.checks.database.status,
+        ...(dbLatency !== undefined && { latency: dbLatency }),
+        poolAvailable: true,
+        pool: {
+          active: pools.database.active,
+          idle: pools.database.idle,
+        },
+        telemetry: pools.telemetry,
+      };
+    }
+
+    // Redis details
+    if (health.checks.redis) {
+      const redisLatency = health.checks.redis.responseTime;
+      details.redis = {
+        status: health.checks.redis.status,
+        ...(redisLatency !== undefined && { latency: redisLatency }),
+        connectionCountAvailable: true,
+        connections: {
+          active: pools.redis.active,
+        },
+        telemetry: pools.telemetry,
+      };
+    }
+
+    // Queue details (real data from BullMQ)
+    if (health.checks.queue) {
+      details.queue = {
+        status: health.checks.queue.status,
+      };
+
+      try {
+        const queue = getQueue();
+        if (queue) {
+          // BullMQ v4+ getJobCounts: pass state names as separate args
+          // Returns object with keys matching exact state names passed
+          const counts = await queue.getJobCounts(
+            'waiting',
+            'active',
+            'completed',
+            'failed',
+            'delayed'
+          ) as Record<string, number>;
+
+          details.queue.jobs = {
+            waiting: counts['waiting'] ?? 0,
+            active: counts['active'] ?? 0,
+            completed: counts['completed'] ?? 0,
+            failed: counts['failed'] ?? 0,
+            delayed: counts['delayed'] ?? 0,
+          };
+        }
+      } catch (err) {
+        logger.error('Failed to fetch queue job counts', {
+          error: err instanceof Error ? err.message : String(err),
+        });
+      }
+    }
+
+    return {
+      details,
+      telemetry: pools.telemetry,
+      timestamp: new Date().toISOString(),
+    };
+  });
+
+  /**
+   * GET /api/monitoring/metrics/http
+   * Detailed HTTP metrics with route breakdown
+   * SECURITY: Requires authentication
+   */
+  fastify.get('/api/monitoring/metrics/http', {
+    ...(preHandler.length > 0 && { preHandler }),
+  }, async (_request: FastifyRequest, _reply: FastifyReply) => {
+    return await getMonitoringHttpPayload();
+  });
+
+  /**
+   * GET /api/monitoring/metrics/runs
+   * Detailed run metrics
+   * SECURITY: Requires authentication
+   */
+  fastify.get('/api/monitoring/metrics/runs', {
+    ...(preHandler.length > 0 && { preHandler }),
+  }, async (_request: FastifyRequest, _reply: FastifyReply) => {
+    return await getMonitoringRunsPayload();
+  });
+
+  /**
+   * GET /api/monitoring/metrics/sse
+   * SSE connection / message counters (Phase 3)
+   */
+  fastify.get('/api/monitoring/metrics/sse', {
+    ...(preHandler.length > 0 && { preHandler }),
+  }, async (_request: FastifyRequest, _reply: FastifyReply) => {
+    return await getMonitoringSsePayload();
+  });
+
+  /**
+   * GET /api/monitoring/metrics/queue
+   * Detailed queue metrics with job states
+   * SECURITY: Requires authentication
+   */
+  fastify.get('/api/monitoring/metrics/queue', {
+    ...(preHandler.length > 0 && { preHandler }),
+  }, async (request: FastifyRequest, reply: FastifyReply) => {
+    try {
+      const queue = getQueue();
+      if (!queue) {
+        return {
+          available: false,
+          message: 'Queue not initialized (Redis required)',
+          timestamp: new Date().toISOString(),
+        };
+      }
+
+      // BullMQ v4+ getJobCounts: returns exact keys matching state names passed
+      const counts = await queue.getJobCounts(
+        'waiting',
+        'active',
+        'completed',
+        'failed',
+        'delayed',
+        'paused'
+      ) as Record<string, number>;
+
+      return {
+        available: true,
+        jobs: {
+          waiting: counts['waiting'] ?? 0,
+          active: counts['active'] ?? 0,
+          completed: counts['completed'] ?? 0,
+          failed: counts['failed'] ?? 0,
+          delayed: counts['delayed'] ?? 0,
+          paused: counts['paused'] ?? 0,
+        },
+        queueName: (queue as any).name || 'run-execution',
+        timestamp: new Date().toISOString(),
+      };
+    } catch (error) {
+      logger.error('Failed to get queue metrics', {
+        error: error instanceof Error ? error.message : String(error),
+      });
+      return {
+        available: false,
+        error: error instanceof Error ? error.message : String(error),
+        timestamp: new Date().toISOString(),
+      };
+    }
+  });
+
+  logger.info('Monitoring routes registered (Phase 0)', {
+    authRequired: preHandler.length > 0,
+    endpoints: [
+      '/api/monitoring/logs',
+      '/api/monitoring/dependencies/detail',
+      '/api/monitoring/metrics/http',
+      '/api/monitoring/metrics/runs',
+      '/api/monitoring/metrics/sse',
+      '/api/monitoring/metrics/queue',
+    ],
+  });
+}

package/dist/gateway-client.d.ts

@@ -102,5 +102,7 @@ export declare class GatewayClient {
      * Raw Prometheus text from GET /metrics (public on Gateway; no auth).
      */
     prometheusMetrics(): Promise<string>;
+    /** GET JSON (monitoring APIs, etc.). Uses same auth headers as the rest of the client. */
+    getJson(path: string): Promise<unknown>;
 }
 //# sourceMappingURL=gateway-client.d.ts.map

package/dist/gateway-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-client.d.ts","sourceRoot":"","sources":["../src/gateway-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAU7D;AAED,6DAA6D;AAC7D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,uFAAuF;IACvF,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,kEAAkE;IAClE,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAchE;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3F,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,UAAU,CAAS;IAE3B,SAAgB,IAAI,EAAE;QACpB,MAAM,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,QAAQ,CAAA;SAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAClE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;KACzE,CAAC;gBAEU,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAmG3F,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IAK5B;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0EjF;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAY3C"}
+{"version":3,"file":"gateway-client.d.ts","sourceRoot":"","sources":["../src/gateway-client.ts"],"names":[],"mappings":"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"}

package/dist/gateway-client.js

@@ -224,5 +224,27 @@ export class GatewayClient {
         const body = response.data;
         return typeof body === 'string' ? body : String(body ?? '');
     }
+    /** GET JSON (monitoring APIs, etc.). Uses same auth headers as the rest of the client. */
+    async getJson(path) {
+        const response = await this.http.get(path, {
+            validateStatus: () => true,
+            timeout: 15000,
+        });
+        if (response.status >= 400) {
+            const body = response.data;
+            const detail = body && typeof body === 'object'
+                ? String(body.error ??
+                    body.message ??
+                    '')
+                : typeof body === 'string'
+                    ? body.slice(0, 240)
+                    : '';
+            const authHint = response.status === 401 || response.status === 403
+                ? ' (authentication failed or expired; reconnect to the Gateway and retry)'
+                : '';
+            throw new Error(`${path} returned HTTP ${response.status}${authHint}${detail ? `: ${detail}` : ''}`);
+        }
+        return response.data;
+    }
 }
 //# sourceMappingURL=gateway-client.js.map