@singhak/nodeui-core 0.3.0 → 0.3.1

package/dist/index.d.mts

@@ -155,9 +155,37 @@ interface RequestEntry {
     timestampMs: number;
     ip: string;
 }
+interface RouteStat {
+    method: string;
+    path: string;
+    count: number;
+    avgMs: number;
+    p95Ms: number;
+    errors: number;
+}
+interface RequestsSummary {
+    /** Requests currently held in the ring buffer. */
+    count: number;
+    errors: number;
+    /** `errors / count` in 0..1 (5xx only). */
+    errorRate: number;
+    avgMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    byStatus: {
+        '2xx': number;
+        '3xx': number;
+        '4xx': number;
+        '5xx': number;
+    };
+    /** Busiest/slowest routes, slowest p95 first (at most 8). */
+    routes: RouteStat[];
+}
 interface RequestsData {
     total: number;
     entries: RequestEntry[];
+    summary: RequestsSummary;
 }
 interface EnvEntry {
     key: string;
@@ -236,7 +264,7 @@ interface ConfigData {
         enabled: boolean;
         pattern: string;
     };
-    authRequired: boolean;
+    locked: boolean;
     /** Plugin panel ids and titles, in registration order. */
     plugins: Array<{
         id: PanelId;
@@ -534,6 +562,7 @@ declare class HeapSnapshotProvider implements NodeUIProvider<HeapSnapshotPanelDa
     takeSnapshot(ctx: ProviderContext): Promise<ProviderResult<HeapSnapshotData>>;
 }
 
+declare function summarizeRequests(entries: readonly RequestEntry[]): RequestsSummary;
 /** Fixed-size ring buffer of recent HTTP requests, recorded via middleware hook. */
 declare class RequestsProvider implements NodeUIProvider<RequestsData> {
     readonly id: "requests";
@@ -737,4 +766,4 @@ type NodeUIMiddleware = (req: IncomingMessage, res: ServerResponse, next: () =>
 declare function serializeEnvelope<T>(envelope: ApiEnvelope<T>, mask?: boolean): string;
 declare function createNodeUI(options?: NodeUIOptions): NodeUIServer;
 
-export { AUTH_COOKIE, type ActivationDecision, type ApiEnvelope, type BuiltInPanelId, type ConfigData, type ConfirmIssued, ConfirmationStore, type CpuClock, type CpuData, CpuProvider, type CpuUsageSnapshot, DEFAULT_LOG_SIZE, type EnvData, type EnvEntry, EnvProvider, type EventLoopClock, EventLoopLagProvider, type EventLoopSample, type GuardOptions, type GuardResult, type HealthCheck, type HealthCheckResult, type HealthData, HealthProvider, type HeapSnapshotData, type HeapSnapshotPanelData, HeapSnapshotProvider, type LogEntry, type LogLevel, type LogsData, LogsProvider, type MemoryData, MemoryProvider, type MetricsBucket, type MetricsData, MetricsProvider, type NodeUIConfig, type NodeUIMiddleware, type NodeUIOptions, type NodeUIProvider, type NodeUIServer, type OutgoingData, OutgoingProvider, type OutgoingRequestEntry, type PanelId, type ProviderContext, type ProviderError, ProviderRegistry, type ProviderResult, type RequestEntry, type RequestsData, RequestsProvider, RingBuffer, type RouteEntry, type RoutesData, RoutesProvider, SECRET_KEY_PATTERN, SECRET_MASKED, Sampler, type SamplerOptions, type SseStream, type StartupData, type StartupMark, StartupTracker, type StaticAsset, createGuard, createNodeUI, extractRoutes, hostnameFromHostHeader, interceptConsole, interceptOutgoing, isLoopbackAddress, isLoopbackHostname, maskSecretText, maskSecrets, matchesAddress, resolveActivation, resolveStaticAsset, serializeEnvelope, startSse };
+export { AUTH_COOKIE, type ActivationDecision, type ApiEnvelope, type BuiltInPanelId, type ConfigData, type ConfirmIssued, ConfirmationStore, type CpuClock, type CpuData, CpuProvider, type CpuUsageSnapshot, DEFAULT_LOG_SIZE, type EnvData, type EnvEntry, EnvProvider, type EventLoopClock, EventLoopLagProvider, type EventLoopSample, type GuardOptions, type GuardResult, type HealthCheck, type HealthCheckResult, type HealthData, HealthProvider, type HeapSnapshotData, type HeapSnapshotPanelData, HeapSnapshotProvider, type LogEntry, type LogLevel, type LogsData, LogsProvider, type MemoryData, MemoryProvider, type MetricsBucket, type MetricsData, MetricsProvider, type NodeUIConfig, type NodeUIMiddleware, type NodeUIOptions, type NodeUIProvider, type NodeUIServer, type OutgoingData, OutgoingProvider, type OutgoingRequestEntry, type PanelId, type ProviderContext, type ProviderError, ProviderRegistry, type ProviderResult, type RequestEntry, type RequestsData, RequestsProvider, type RequestsSummary, RingBuffer, type RouteEntry, type RouteStat, type RoutesData, RoutesProvider, SECRET_KEY_PATTERN, SECRET_MASKED, Sampler, type SamplerOptions, type SseStream, type StartupData, type StartupMark, StartupTracker, type StaticAsset, createGuard, createNodeUI, extractRoutes, hostnameFromHostHeader, interceptConsole, interceptOutgoing, isLoopbackAddress, isLoopbackHostname, maskSecretText, maskSecrets, matchesAddress, resolveActivation, resolveStaticAsset, serializeEnvelope, startSse, summarizeRequests };

package/dist/index.d.ts

@@ -155,9 +155,37 @@ interface RequestEntry {
     timestampMs: number;
     ip: string;
 }
+interface RouteStat {
+    method: string;
+    path: string;
+    count: number;
+    avgMs: number;
+    p95Ms: number;
+    errors: number;
+}
+interface RequestsSummary {
+    /** Requests currently held in the ring buffer. */
+    count: number;
+    errors: number;
+    /** `errors / count` in 0..1 (5xx only). */
+    errorRate: number;
+    avgMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    byStatus: {
+        '2xx': number;
+        '3xx': number;
+        '4xx': number;
+        '5xx': number;
+    };
+    /** Busiest/slowest routes, slowest p95 first (at most 8). */
+    routes: RouteStat[];
+}
 interface RequestsData {
     total: number;
     entries: RequestEntry[];
+    summary: RequestsSummary;
 }
 interface EnvEntry {
     key: string;
@@ -236,7 +264,7 @@ interface ConfigData {
         enabled: boolean;
         pattern: string;
     };
-    authRequired: boolean;
+    locked: boolean;
     /** Plugin panel ids and titles, in registration order. */
     plugins: Array<{
         id: PanelId;
@@ -534,6 +562,7 @@ declare class HeapSnapshotProvider implements NodeUIProvider<HeapSnapshotPanelDa
     takeSnapshot(ctx: ProviderContext): Promise<ProviderResult<HeapSnapshotData>>;
 }
 
+declare function summarizeRequests(entries: readonly RequestEntry[]): RequestsSummary;
 /** Fixed-size ring buffer of recent HTTP requests, recorded via middleware hook. */
 declare class RequestsProvider implements NodeUIProvider<RequestsData> {
     readonly id: "requests";
@@ -737,4 +766,4 @@ type NodeUIMiddleware = (req: IncomingMessage, res: ServerResponse, next: () =>
 declare function serializeEnvelope<T>(envelope: ApiEnvelope<T>, mask?: boolean): string;
 declare function createNodeUI(options?: NodeUIOptions): NodeUIServer;
 
-export { AUTH_COOKIE, type ActivationDecision, type ApiEnvelope, type BuiltInPanelId, type ConfigData, type ConfirmIssued, ConfirmationStore, type CpuClock, type CpuData, CpuProvider, type CpuUsageSnapshot, DEFAULT_LOG_SIZE, type EnvData, type EnvEntry, EnvProvider, type EventLoopClock, EventLoopLagProvider, type EventLoopSample, type GuardOptions, type GuardResult, type HealthCheck, type HealthCheckResult, type HealthData, HealthProvider, type HeapSnapshotData, type HeapSnapshotPanelData, HeapSnapshotProvider, type LogEntry, type LogLevel, type LogsData, LogsProvider, type MemoryData, MemoryProvider, type MetricsBucket, type MetricsData, MetricsProvider, type NodeUIConfig, type NodeUIMiddleware, type NodeUIOptions, type NodeUIProvider, type NodeUIServer, type OutgoingData, OutgoingProvider, type OutgoingRequestEntry, type PanelId, type ProviderContext, type ProviderError, ProviderRegistry, type ProviderResult, type RequestEntry, type RequestsData, RequestsProvider, RingBuffer, type RouteEntry, type RoutesData, RoutesProvider, SECRET_KEY_PATTERN, SECRET_MASKED, Sampler, type SamplerOptions, type SseStream, type StartupData, type StartupMark, StartupTracker, type StaticAsset, createGuard, createNodeUI, extractRoutes, hostnameFromHostHeader, interceptConsole, interceptOutgoing, isLoopbackAddress, isLoopbackHostname, maskSecretText, maskSecrets, matchesAddress, resolveActivation, resolveStaticAsset, serializeEnvelope, startSse };
+export { AUTH_COOKIE, type ActivationDecision, type ApiEnvelope, type BuiltInPanelId, type ConfigData, type ConfirmIssued, ConfirmationStore, type CpuClock, type CpuData, CpuProvider, type CpuUsageSnapshot, DEFAULT_LOG_SIZE, type EnvData, type EnvEntry, EnvProvider, type EventLoopClock, EventLoopLagProvider, type EventLoopSample, type GuardOptions, type GuardResult, type HealthCheck, type HealthCheckResult, type HealthData, HealthProvider, type HeapSnapshotData, type HeapSnapshotPanelData, HeapSnapshotProvider, type LogEntry, type LogLevel, type LogsData, LogsProvider, type MemoryData, MemoryProvider, type MetricsBucket, type MetricsData, MetricsProvider, type NodeUIConfig, type NodeUIMiddleware, type NodeUIOptions, type NodeUIProvider, type NodeUIServer, type OutgoingData, OutgoingProvider, type OutgoingRequestEntry, type PanelId, type ProviderContext, type ProviderError, ProviderRegistry, type ProviderResult, type RequestEntry, type RequestsData, RequestsProvider, type RequestsSummary, RingBuffer, type RouteEntry, type RouteStat, type RoutesData, RoutesProvider, SECRET_KEY_PATTERN, SECRET_MASKED, Sampler, type SamplerOptions, type SseStream, type StartupData, type StartupMark, StartupTracker, type StaticAsset, createGuard, createNodeUI, extractRoutes, hostnameFromHostHeader, interceptConsole, interceptOutgoing, isLoopbackAddress, isLoopbackHostname, maskSecretText, maskSecrets, matchesAddress, resolveActivation, resolveStaticAsset, serializeEnvelope, startSse, summarizeRequests };

package/dist/index.mjs

@@ -915,6 +915,54 @@ var HeapSnapshotProvider = class {
 
 // src/providers/requests.ts
 var RESPONSE_PAGE_SIZE2 = 100;
+var MAX_ROUTE_STATS = 8;
+function percentile(sorted, p) {
+  if (sorted.length === 0) return 0;
+  const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(p * sorted.length) - 1));
+  return sorted[index] ?? 0;
+}
+function routeKey(path2) {
+  return path2.split("/").map(
+    (seg) => /^\d+$/.test(seg) || /^[0-9a-f]{8}-[0-9a-f-]{27}$/i.test(seg) || /^[0-9a-f]{24}$/i.test(seg) ? ":id" : seg
+  ).join("/");
+}
+function summarizeRequests(entries) {
+  const durations = entries.map((e) => e.durationMs).sort((a, b) => a - b);
+  const byStatus = { "2xx": 0, "3xx": 0, "4xx": 0, "5xx": 0 };
+  const groups = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const bucket = `${Math.floor(e.status / 100)}xx`;
+    if (bucket in byStatus) byStatus[bucket] += 1;
+    const path2 = routeKey(e.path);
+    const key = `${e.method} ${path2}`;
+    const group = groups.get(key) ?? { method: e.method, path: path2, ms: [], errors: 0 };
+    group.ms.push(e.durationMs);
+    if (e.status >= 500) group.errors += 1;
+    groups.set(key, group);
+  }
+  const routes = [...groups.values()].map((g) => {
+    const sorted = [...g.ms].sort((a, b) => a - b);
+    return {
+      method: g.method,
+      path: g.path,
+      count: g.ms.length,
+      avgMs: g.ms.reduce((a, b) => a + b, 0) / g.ms.length,
+      p95Ms: percentile(sorted, 0.95),
+      errors: g.errors
+    };
+  }).sort((a, b) => b.p95Ms - a.p95Ms).slice(0, MAX_ROUTE_STATS);
+  return {
+    count: entries.length,
+    errors: byStatus["5xx"],
+    errorRate: entries.length === 0 ? 0 : byStatus["5xx"] / entries.length,
+    avgMs: durations.length === 0 ? 0 : durations.reduce((a, b) => a + b, 0) / durations.length,
+    p50Ms: percentile(durations, 0.5),
+    p95Ms: percentile(durations, 0.95),
+    p99Ms: percentile(durations, 0.99),
+    byStatus,
+    routes
+  };
+}
 var RequestsProvider = class {
   id = "requests";
   buffer;
@@ -931,7 +979,8 @@ var RequestsProvider = class {
   }
   get() {
     const entries = this.buffer.slice(Math.max(0, this.buffer.length - RESPONSE_PAGE_SIZE2));
-    return { ok: true, data: { total: this.buffer.length, entries } };
+    const summary = summarizeRequests(this.buffer.toArray());
+    return { ok: true, data: { total: this.buffer.length, entries, summary } };
   }
 };
 
@@ -1453,7 +1502,7 @@ function createNodeUI(options = {}) {
       pollIntervalMs: config.pollIntervalMs,
       panels: registry.ids(),
       masking: { enabled: config.maskSecrets, pattern: SECRET_KEY_PATTERN.source },
-      authRequired: config.authRequired,
+      locked: config.authRequired,
       plugins: pluginMeta
     };
   }
@@ -1722,6 +1771,7 @@ export {
   resolveActivation,
   resolveStaticAsset,
   serializeEnvelope,
-  startSse
+  startSse,
+  summarizeRequests
 };
 //# sourceMappingURL=index.mjs.map