axusage 3.8.2 → 3.8.3

package/README.md

@@ -185,23 +185,34 @@ axusage serve --port 9090 --interval 60 --service claude
 
 # With environment variables
 AXUSAGE_PORT=9090 AXUSAGE_INTERVAL=60 axusage serve
+
+# With debug logging
+AXUSAGE_LOG_LEVEL=debug axusage serve
 ```
 
 ### Options
 
-| Flag                   | Env Var            | Default     | Description              |
-| ---------------------- | ------------------ | ----------- | ------------------------ |
-| `--port <port>`        | `AXUSAGE_PORT`     | `3848`      | Port to listen on        |
-| `--host <host>`        | `AXUSAGE_HOST`     | `127.0.0.1` | Host to bind to          |
-| `--interval <seconds>` | `AXUSAGE_INTERVAL` | `300`       | Max cache age in seconds |
-| `--service <service>`  | `AXUSAGE_SERVICE`  | all         | Service to monitor       |
+| Flag                   | Env Var               | Default     | Description                                           |
+| ---------------------- | --------------------- | ----------- | ----------------------------------------------------- |
+| `--port <port>`        | `AXUSAGE_PORT`        | `3848`      | Port to listen on                                     |
+| `--host <host>`        | `AXUSAGE_HOST`        | `127.0.0.1` | Host to bind to                                       |
+| `--interval <seconds>` | `AXUSAGE_INTERVAL`    | `300`       | Max cache age in seconds                              |
+| `--log-level <level>`  | `AXUSAGE_LOG_LEVEL`   | `info`      | Fastify/Pino log level                                |
+| `--service <service>`  | `AXUSAGE_SERVICE`     | all         | Service to monitor                                    |
+| —                      | `AXUSAGE_TRUST_PROXY` | `false`     | Trust proxy headers (set `true` behind reverse proxy) |
+
+Invalid serve-mode configuration now fails fast. For example, non-numeric ports, zero/negative intervals, or unsupported log levels exit with an error instead of silently falling back to defaults.
 
 ### Endpoints
 
-- `GET /metrics` — Prometheus text exposition (`text/plain; version=0.0.4`). Serves cached data immediately; triggers a background refresh when stale. Returns 503 when all services are currently failing.
-- `GET /usage` — JSON array of usage objects (one per service instance; multi-instance configs produce multiple entries per service type). Waits for a fresh snapshot when stale. Returns 503 if no data is available. Date fields (e.g. `resetsAt`) are serialized as ISO 8601 strings.
+- `GET /metrics` — Prometheus text exposition (`text/plain; version=0.0.4`). Serves cached data immediately; triggers a background refresh when stale. Returns 503 with JSON `{ "error": "No data yet" }` when no usage data is available.
+- `GET /usage` — JSON array of usage objects (one per service instance; multi-instance configs produce multiple entries per service type). Waits for a fresh snapshot when stale. Returns 503 with JSON `{ "error": "No data yet" }` if no data is available. Date fields (e.g. `resetsAt`) are serialized as ISO 8601 strings.
 - `GET /health` — JSON health status with version, last refresh time, tracked services, and errors. Always responds immediately from cached state without triggering a refresh.
 
+Rate limiting is applied globally (100 req/min per client); `/health` and `/metrics` are exempt. Unmatched routes (404s) are also rate-limited to prevent URL probing. Security headers are set via `@fastify/helmet`.
+
+Serve mode uses Fastify's structured logger and graceful shutdown handling. Request/response validation and serialization are enforced with Zod-backed route schemas.
+
 ### Container Deployment
 
 ```bash

package/dist/cli.js

@@ -6,6 +6,7 @@ import { authStatusCommand } from "./commands/auth-status-command.js";
 import { serveCommand } from "./commands/serve-command.js";
 import { usageCommand } from "./commands/usage-command.js";
 import { getCredentialSourcesPath } from "./config/credential-sources.js";
+import { SERVE_LOG_LEVELS } from "./config/serve-config.js";
 import { getAvailableServices } from "./services/service-adapter-registry.js";
 import { configureColor } from "./utils/color.js";
 import { formatRequiresHelpText } from "./utils/format-requires-help-text.js";
@@ -35,6 +36,7 @@ program
     .option("-p, --port <port>", "Port to listen on (env: AXUSAGE_PORT)")
     .option("-H, --host <host>", "Host to bind to (env: AXUSAGE_HOST)")
     .option("--interval <seconds>", "Max cache age in seconds (env: AXUSAGE_INTERVAL)")
+    .addOption(new Option("--log-level <level>", "Server log level (env: AXUSAGE_LOG_LEVEL)").choices([...SERVE_LOG_LEVELS]))
     .option("-s, --service <service>", "Service to monitor (env: AXUSAGE_SERVICE, default: all)")
     .action(async (options) => {
     await serveCommand(options);

package/dist/cli.js.map

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

package/dist/commands/fetch-service-usage.d.ts

@@ -1,14 +1,15 @@
-import type { ServiceResult } from "../types/domain.js";
+import { type ServiceResult } from "../types/domain.js";
+import { type SupportedService } from "../services/supported-service.js";
 export type UsageCommandOptions = {
     readonly service?: string;
     readonly format?: "text" | "tsv" | "json" | "prometheus";
 };
-export declare function selectServicesToQuery(service?: string): string[];
+export declare function selectServicesToQuery(service?: string): SupportedService[];
 /**
  * Fetch usage for all instances of a service type.
  *
  * Resolves tokens and fetches usage for each configured instance in parallel.
  * Produces N results with resolved display names and stable instance IDs.
  */
-export declare function fetchServiceInstanceUsage(serviceType: string): Promise<ServiceResult[]>;
+export declare function fetchServiceInstanceUsage(serviceType: SupportedService): Promise<ServiceResult[]>;
 //# sourceMappingURL=fetch-service-usage.d.ts.map

package/dist/commands/fetch-service-usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-service-usage.d.ts","sourceRoot":"","sources":["../../src/commands/fetch-service-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWlE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;CAC1D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAIhE;AAiBD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAwF1B"}
+{"version":3,"file":"fetch-service-usage.d.ts","sourceRoot":"","sources":["../../src/commands/fetch-service-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQlE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;CAC1D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAI1E;AAiBD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,CAoE1B"}

package/dist/commands/fetch-service-usage.js

@@ -1,13 +1,13 @@
-import { ApiError as ApiErrorClass } from "../types/domain.js";
+import { ApiError } from "../types/domain.js";
 import { getAvailableServices, getServiceUsageFetcher, } from "../services/service-adapter-registry.js";
 import { getServiceInstanceConfigs } from "../config/credential-sources.js";
 import { getInstanceAccessToken } from "../services/get-instance-access-token.js";
 import { resolveInstanceDisplayName } from "../services/resolve-service-instances.js";
+import { validateService, } from "../services/supported-service.js";
 export function selectServicesToQuery(service) {
-    const normalized = service?.toLowerCase();
-    if (!service || normalized === "all")
+    if (!service || service.toLowerCase() === "all")
         return getAvailableServices();
-    return [service];
+    return [validateService(service)];
 }
 /**
  * Derive a stable instance identifier for metrics labeling.
@@ -27,33 +27,19 @@ function deriveInstanceId(serviceType, credentialName, index, total) {
  * Produces N results with resolved display names and stable instance IDs.
  */
 export async function fetchServiceInstanceUsage(serviceType) {
-    const normalized = serviceType.toLowerCase();
-    const fetcher = getServiceUsageFetcher(normalized);
-    if (!fetcher) {
-        const available = getAvailableServices().join(", ");
-        return [
-            {
-                service: serviceType,
-                result: {
-                    ok: false,
-                    error: new ApiErrorClass(`Unknown service "${serviceType}". Supported services: ${available}. ` +
-                        "Run 'axusage --help' for usage."),
-                },
-            },
-        ];
-    }
-    const instanceConfigs = getServiceInstanceConfigs(normalized);
+    const fetcher = getServiceUsageFetcher(serviceType);
+    const instanceConfigs = getServiceInstanceConfigs(serviceType);
     const results = await Promise.all(instanceConfigs.map(async (config, index) => {
-        const tokenResult = await getInstanceAccessToken(normalized, config);
+        const tokenResult = await getInstanceAccessToken(serviceType, config);
         if (!tokenResult.token) {
-            const label = config.name ?? normalized;
+            const label = config.name ?? serviceType;
             const isVaultPath = config.source === "vault" ||
                 (config.source === "auto" && config.name !== undefined);
             return {
-                service: normalized,
+                service: serviceType,
                 result: {
                     ok: false,
-                    error: new ApiErrorClass(`No credentials found for ${label}. ` +
+                    error: new ApiError(`No credentials found for ${label}. ` +
                         (isVaultPath
                             ? config.name
                                 ? `Check that vault is configured and credential "${config.name}" exists.`
@@ -65,9 +51,9 @@ export async function fetchServiceInstanceUsage(serviceType) {
         const usageResult = await fetcher.fetchUsageWithToken(tokenResult.token);
         if (usageResult.ok) {
             const displayName = resolveInstanceDisplayName(config.displayName, tokenResult.vaultDisplayName, fetcher.name, index, instanceConfigs.length);
-            const instanceId = deriveInstanceId(normalized, config.name, index, instanceConfigs.length);
+            const instanceId = deriveInstanceId(serviceType, config.name, index, instanceConfigs.length);
             return {
-                service: normalized,
+                service: serviceType,
                 result: {
                     ok: true,
                     value: {
@@ -79,7 +65,7 @@ export async function fetchServiceInstanceUsage(serviceType) {
             };
         }
         return {
-            service: normalized,
+            service: serviceType,
             result: usageResult,
         };
     }));

package/dist/commands/fetch-service-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-service-usage.js","sourceRoot":"","sources":["../../src/commands/fetch-service-usage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch-service-usage.js","sourceRoot":"","sources":["../../src/commands/fetch-service-usage.ts"],"names":[],"mappings":"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"}

package/dist/commands/serve-command.d.ts

@@ -1,31 +1,13 @@
 /**
  * Serve command handler — starts an HTTP server exposing usage data.
  */
-import { type ServerState } from "../server/routes.js";
-import type { ServiceResult } from "../types/domain.js";
 type ServeCommandOptions = {
     readonly port?: string;
     readonly host?: string;
     readonly interval?: string;
     readonly service?: string;
+    readonly logLevel?: string;
 };
-type UsageCache = {
-    readonly getState: () => ServerState | undefined;
-    /** Waits for a fresh snapshot before returning. Use for data endpoints where staleness is unacceptable. */
-    readonly getFreshState: () => Promise<ServerState | undefined>;
-    /** Serves the current snapshot immediately; triggers a background refresh when stale.
-     *  Blocks only if no snapshot exists yet (first ever request). Use for Prometheus /metrics
-     *  where scrape latency matters more than strict freshness. */
-    readonly getStateStaleWhileRevalidate: () => Promise<ServerState | undefined>;
-};
-/**
- * Creates an on-demand usage cache. Data is fetched via `doFetch` when a
- * caller requests fresh state and the cached snapshot is older than `intervalMs`.
- * Concurrent callers during a refresh all receive the same in-flight promise.
- * When all services fail, the cache retries after a short backoff (≤5s) rather
- * than waiting the full interval.
- */
-export declare function createUsageCache(doFetch: () => Promise<ServiceResult[]>, intervalMs: number): UsageCache;
 export declare function serveCommand(options: ServeCommandOptions): Promise<void>;
 export {};
 //# sourceMappingURL=serve-command.d.ts.map

package/dist/commands/serve-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve-command.d.ts","sourceRoot":"","sources":["../../src/commands/serve-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AAE1E,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACjD,2GAA2G;IAC3G,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC/D;;mEAE+D;IAC/D,QAAQ,CAAC,4BAA4B,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CAC/E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,EACvC,UAAU,EAAE,MAAM,GACjB,UAAU,CA+DZ;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsEf"}
+{"version":3,"file":"serve-command.d.ts","sourceRoot":"","sources":["../../src/commands/serve-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Ef"}

package/dist/commands/serve-command.js

@@ -1,123 +1,61 @@
 /**
  * Serve command handler — starts an HTTP server exposing usage data.
  */
+import closeWithGrace from "close-with-grace";
 import { getServeConfig } from "../config/serve-config.js";
 import { selectServicesToQuery } from "./fetch-service-usage.js";
 import { fetchServicesInParallel } from "./usage-command.js";
+import { createDeferredServeLogger } from "../server/serve-logger.js";
 import { createServer } from "../server/server.js";
-import { createHealthRouter, createMetricsRouter, createUsageRouter, } from "../server/routes.js";
-import { getAvailableServices } from "../services/service-adapter-registry.js";
-/**
- * Creates an on-demand usage cache. Data is fetched via `doFetch` when a
- * caller requests fresh state and the cached snapshot is older than `intervalMs`.
- * Concurrent callers during a refresh all receive the same in-flight promise.
- * When all services fail, the cache retries after a short backoff (≤5s) rather
- * than waiting the full interval.
- */
-export function createUsageCache(doFetch, intervalMs) {
-    let state;
-    let refreshPromise;
-    async function doRefresh() {
-        const results = await doFetch();
-        const usage = [];
-        const errors = [];
-        for (const { service, result } of results) {
-            if (result.ok) {
-                usage.push(result.value);
-            }
-            else {
-                const statusSuffix = result.error.status === undefined
-                    ? ""
-                    : ` (HTTP ${String(result.error.status)})`;
-                errors.push(`${service}: fetch failed${statusSuffix}`);
-                console.error(`Warning: Failed to fetch ${service}: ${result.error.message}`);
-            }
-        }
-        state = { usage, refreshedAt: new Date(), errors };
-    }
-    function ensureFresh() {
-        const age = state === undefined ? Infinity : Date.now() - state.refreshedAt.getTime();
-        // If the last refresh produced no data (all services failed), retry on a
-        // short backoff so the server recovers promptly after transient failures
-        // rather than waiting the full cache interval.
-        const hasData = state !== undefined && state.usage.length > 0;
-        const maxAge = hasData ? intervalMs : Math.min(intervalMs, 5000);
-        if (age < maxAge)
-            return Promise.resolve();
-        refreshPromise ??= doRefresh().finally(() => {
-            refreshPromise = undefined;
-        });
-        return refreshPromise;
-    }
-    return {
-        getState: () => state,
-        getFreshState: async () => {
-            await ensureFresh();
-            return state;
-        },
-        getStateStaleWhileRevalidate: async () => {
-            if (state === undefined) {
-                // No snapshot yet — block until we have something to serve.
-                await ensureFresh();
-            }
-            else {
-                // Serve the current snapshot immediately; kick off a background
-                // refresh if stale. Errors are logged; callers are not affected.
-                void ensureFresh().catch((error) => {
-                    console.error("Background metrics refresh failed:", error);
-                });
-            }
-            return state;
-        },
-    };
-}
+import { createHealthPlugin, createMetricsPlugin, createUsagePlugin, } from "../server/routes.js";
+import { createUsageCache } from "../server/usage-cache.js";
 export async function serveCommand(options) {
     const config = getServeConfig(options);
-    const availableServices = getAvailableServices();
-    if (config.service !== undefined &&
-        config.service.toLowerCase() !== "all" &&
-        !availableServices.includes(config.service.toLowerCase())) {
-        console.error(`Unknown service "${config.service}". Supported: ${availableServices.join(", ")}.`);
-        if (process.exitCode === undefined)
-            process.exitCode = 1;
-        return;
-    }
     const servicesToQuery = selectServicesToQuery(config.service);
-    const cache = createUsageCache(() => fetchServicesInParallel(servicesToQuery), config.intervalMs);
+    const serverReference = { current: undefined };
+    const logger = createDeferredServeLogger(() => serverReference.current?.app.log);
+    let shuttingDown = false;
+    const cache = createUsageCache(() => fetchServicesInParallel(servicesToQuery), config.intervalMs, logger);
     const server = createServer(config, [
-        createHealthRouter(servicesToQuery, cache.getState),
-        createMetricsRouter(cache.getStateStaleWhileRevalidate),
-        createUsageRouter(cache.getFreshState),
+        createHealthPlugin(servicesToQuery, cache.getState, () => shuttingDown),
+        createMetricsPlugin(cache.getStateStaleWhileRevalidate),
+        createUsagePlugin(cache.getFreshState),
     ]);
-    const shutdown = () => {
-        console.error("\nShutting down...");
-        const forceExit = setTimeout(() => {
-            console.error("Shutdown timed out, forcing exit");
-            // eslint-disable-next-line unicorn/no-process-exit -- CLI graceful shutdown
-            process.exit(1);
-        }, 5000);
-        forceExit.unref();
-        server
-            .stop()
-            .finally(() => {
-            clearTimeout(forceExit);
-        })
-            .then(() => {
-            // eslint-disable-next-line unicorn/no-process-exit -- CLI graceful shutdown
-            process.exit(0);
-        }, (error) => {
-            console.error("Error during shutdown:", error);
-            // eslint-disable-next-line unicorn/no-process-exit -- CLI graceful shutdown
-            process.exit(1);
+    serverReference.current = server;
+    // Register shutdown handler before the initial fetch so signals arriving
+    // at any point during startup are caught instead of using Node's default
+    // (immediate termination).
+    closeWithGrace({
+        delay: 5000,
+        logger: false,
+        onTimeout(delay) {
+            server.app.log.error({ delay }, "Graceful shutdown timed out");
+        },
+    }, async ({ signal, err, manual }) => {
+        shuttingDown = true;
+        cache.shutdown();
+        if (err) {
+            server.app.log.error({ err, signal, manual }, "Shutting down axusage server due to fatal error");
+        }
+        else {
+            server.app.log.info({ signal, manual }, "Shutting down axusage server");
+        }
+        await server.stop();
+        await cache.waitForPending().catch((error) => {
+            server.app.log.warn({ err: error }, "In-flight refresh failed during shutdown");
         });
-    };
-    process.once("SIGTERM", shutdown);
-    process.once("SIGINT", shutdown);
+    });
     // Pre-populate the cache before accepting connections so /health returns a
     // meaningful status immediately (important for container readiness checks).
-    console.error(`Fetching initial data for: ${servicesToQuery.join(", ")}`);
+    server.app.log.info({ services: servicesToQuery }, "Fetching initial data for serve mode");
     await cache.getFreshState();
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- mutated by closeWithGrace signal handler above
+    if (shuttingDown)
+        return;
     await server.start();
-    console.error(`Serving usage for: ${servicesToQuery.join(", ")} (max age: ${String(config.intervalMs / 1000)}s)`);
+    server.app.log.info({
+        services: servicesToQuery,
+        maxAgeSeconds: config.intervalMs / 1000,
+    }, "Serving usage");
 }
 //# sourceMappingURL=serve-command.js.map

package/dist/commands/serve-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"serve-command.js","sourceRoot":"","sources":["../../src/commands/serve-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serve-command.js","sourceRoot":"","sources":["../../src/commands/serve-command.ts"],"names":[],"mappings":"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"}

package/dist/commands/usage-command.d.ts

@@ -1,10 +1,11 @@
 import type { ServiceResult } from "../types/domain.js";
+import type { SupportedService } from "../services/supported-service.js";
 import type { UsageCommandOptions } from "./fetch-service-usage.js";
 /**
  * Fetches usage for all requested services in parallel.
  * Each service type may produce multiple results (multi-instance support).
  */
-export declare function fetchServicesInParallel(servicesToQuery: string[]): Promise<ServiceResult[]>;
+export declare function fetchServicesInParallel(servicesToQuery: SupportedService[]): Promise<ServiceResult[]>;
 /**
  * Executes the usage command
  */

package/dist/commands/usage-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-command.d.ts","sourceRoot":"","sources":["../../src/commands/usage-command.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQpE;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAO1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkHf"}
+{"version":3,"file":"usage-command.d.ts","sourceRoot":"","sources":["../../src/commands/usage-command.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQpE;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,gBAAgB,EAAE,GAClC,OAAO,CAAC,aAAa,EAAE,CAAC,CAO1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsHf"}

package/dist/commands/usage-command.js

@@ -109,6 +109,10 @@ export async function usageCommand(options) {
             }
             break;
         }
+        default: {
+            const _exhaustive = format;
+            throw new Error(`Unhandled format: ${String(_exhaustive)}`);
+        }
     }
     if (hasPartialFailures) {
         process.exitCode = 1;

package/dist/commands/usage-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-command.js","sourceRoot":"","sources":["../../src/commands/usage-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage-command.js","sourceRoot":"","sources":["../../src/commands/usage-command.ts"],"names":[],"mappings":"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"}

package/dist/config/serve-config.d.ts

@@ -3,17 +3,32 @@
  *
  * Priority: CLI flags > environment variables > defaults.
  */
+import { z } from "zod";
+export declare const SERVE_LOG_LEVELS: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+declare const ServeLogLevelSchema: z.ZodEnum<{
+    error: "error";
+    trace: "trace";
+    debug: "debug";
+    info: "info";
+    warn: "warn";
+    fatal: "fatal";
+    silent: "silent";
+}>;
+export type ServeLogLevel = z.infer<typeof ServeLogLevelSchema>;
 export type ServeConfig = {
     readonly port: number;
     readonly host: string;
     readonly intervalMs: number;
     readonly service: string | undefined;
+    readonly logLevel: ServeLogLevel;
+    readonly trustProxy: boolean;
 };
 type ServeConfigOverrides = {
     readonly port?: string;
     readonly host?: string;
     readonly interval?: string;
     readonly service?: string;
+    readonly logLevel?: string;
 };
 /** Parse serve config from environment and CLI overrides */
 export declare function getServeConfig(overrides?: ServeConfigOverrides): ServeConfig;

package/dist/config/serve-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve-config.d.ts","sourceRoot":"","sources":["../../src/config/serve-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAMF,4DAA4D;AAC5D,wBAAgB,cAAc,CAC5B,SAAS,GAAE,oBAAyB,GACnC,WAAW,CAkBb"}
+{"version":3,"file":"serve-config.d.ts","sourceRoot":"","sources":["../../src/config/serve-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,yEAQnB,CAAC;AAEX,QAAA,MAAM,mBAAmB;;;;;;;;EAA2B,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAcF,4DAA4D;AAC5D,wBAAgB,cAAc,CAC5B,SAAS,GAAE,oBAAyB,GACnC,WAAW,CAsCb"}