axusage 3.8.2 → 3.8.3

package/dist/config/serve-config.js

@@ -3,39 +3,78 @@
  *
  * Priority: CLI flags > environment variables > defaults.
  */
+import { z } from "zod";
+export const SERVE_LOG_LEVELS = [
+    "trace",
+    "debug",
+    "info",
+    "warn",
+    "error",
+    "fatal",
+    "silent",
+];
+const ServeLogLevelSchema = z.enum(SERVE_LOG_LEVELS);
 const DEFAULT_PORT = 3848;
 const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_INTERVAL_SECONDS = 300; // 5 minutes
+const DEFAULT_LOG_LEVEL = "info";
+class ServeConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ServeConfigError";
+    }
+}
 /** Parse serve config from environment and CLI overrides */
 export function getServeConfig(overrides = {}) {
-    const port = parsePort(overrides.port ?? process.env.AXUSAGE_PORT);
-    const host = overrides.host || process.env.AXUSAGE_HOST || DEFAULT_HOST;
-    const intervalSeconds = parsePositiveInt(overrides.interval ?? process.env.AXUSAGE_INTERVAL, DEFAULT_INTERVAL_SECONDS, "AXUSAGE_INTERVAL");
-    const service = (overrides.service ?? process.env.AXUSAGE_SERVICE) || undefined;
+    const port = parseIntegerOption(normalizeOptionalValue(overrides.port ?? process.env.AXUSAGE_PORT), {
+        label: "AXUSAGE_PORT",
+        defaultValue: DEFAULT_PORT,
+        min: 1,
+        max: 65_535,
+    });
+    const host = normalizeOptionalValue(overrides.host ?? process.env.AXUSAGE_HOST) ??
+        DEFAULT_HOST;
+    const intervalSeconds = parseIntegerOption(normalizeOptionalValue(overrides.interval ?? process.env.AXUSAGE_INTERVAL), {
+        label: "AXUSAGE_INTERVAL",
+        defaultValue: DEFAULT_INTERVAL_SECONDS,
+        min: 1,
+    });
+    const service = normalizeOptionalValue(overrides.service ?? process.env.AXUSAGE_SERVICE)?.toLowerCase();
+    const logLevel = parseLogLevel(normalizeOptionalValue(overrides.logLevel ?? process.env.AXUSAGE_LOG_LEVEL));
+    const trustProxy = normalizeOptionalValue(process.env.AXUSAGE_TRUST_PROXY) === "true";
     return {
         port,
         host,
         intervalMs: intervalSeconds * 1000,
         service,
+        logLevel,
+        trustProxy,
     };
 }
-function parsePort(value) {
-    if (!value)
-        return DEFAULT_PORT;
-    const port = Number(value);
-    if (!Number.isInteger(port) || port < 1 || port > 65_535) {
-        throw new Error(`Invalid port: ${value}`);
-    }
-    return port;
+function normalizeOptionalValue(value) {
+    const normalized = value?.trim();
+    return normalized || undefined;
 }
-function parsePositiveInt(value, defaultValue, name) {
-    if (!value)
-        return defaultValue;
+function parseIntegerOption(value, options) {
+    if (value === undefined)
+        return options.defaultValue;
     const parsed = Number(value);
-    if (!Number.isInteger(parsed) || parsed < 1) {
-        console.error(`Invalid ${name} value "${value}", using default ${String(defaultValue)}`);
-        return defaultValue;
+    if (!Number.isInteger(parsed) ||
+        parsed < options.min ||
+        (options.max !== undefined && parsed > options.max)) {
+        const bounds = options.max === undefined
+            ? `an integer >= ${String(options.min)}`
+            : `an integer between ${String(options.min)} and ${String(options.max)}`;
+        throw new ServeConfigError(`Invalid ${options.label} value "${value}". Expected ${bounds}.`);
     }
     return parsed;
 }
+function parseLogLevel(value) {
+    if (value === undefined)
+        return DEFAULT_LOG_LEVEL;
+    const parsed = ServeLogLevelSchema.safeParse(value.toLowerCase());
+    if (parsed.success)
+        return parsed.data;
+    throw new ServeConfigError(`Invalid AXUSAGE_LOG_LEVEL value "${value}". Expected one of: ${SERVE_LOG_LEVELS.join(", ")}.`);
+}
 //# sourceMappingURL=serve-config.js.map

package/dist/config/serve-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"serve-config.js","sourceRoot":"","sources":["../../src/config/serve-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,wBAAwB,GAAG,GAAG,CAAC,CAAC,YAAY;AAElD,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAC5B,YAAkC,EAAE;IAEpC,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,YAAY,CAAC;IACxE,MAAM,eAAe,GAAG,gBAAgB,CACtC,SAAS,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAClD,wBAAwB,EACxB,kBAAkB,CACnB,CAAC;IAEF,MAAM,OAAO,GACX,CAAC,SAAS,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC;IAElE,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,UAAU,EAAE,eAAe,GAAG,IAAI;QAClC,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAyB,EACzB,YAAoB,EACpB,IAAY;IAEZ,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,KAAK,CACX,WAAW,IAAI,WAAW,KAAK,oBAAoB,MAAM,CAAC,YAAY,CAAC,EAAE,CAC1E,CAAC;QACF,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"serve-config.js","sourceRoot":"","sources":["../../src/config/serve-config.ts"],"names":[],"mappings":"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"}

package/dist/server/routes.d.ts

@@ -1,18 +1,24 @@
 /**
  * Route handlers for axusage serve mode.
  */
-import { Router } from "express";
+import type { FastifyPluginCallbackZod } from "fastify-type-provider-zod";
 import type { ServiceUsageData } from "../types/domain.js";
+/** Structured error from a failed service fetch. */
+export type ServerError = {
+    readonly service: string;
+    readonly message: string;
+    readonly status?: number;
+};
 /** Snapshot produced by each refresh cycle. */
 export type ServerState = {
     readonly usage: readonly ServiceUsageData[];
     readonly refreshedAt: Date;
-    readonly errors: readonly string[];
+    readonly errors: readonly ServerError[];
 };
-/** Create router for GET /health */
-export declare function createHealthRouter(services: readonly string[], getState: () => ServerState | undefined): Router;
-/** Create router for GET /metrics (Prometheus text exposition) */
-export declare function createMetricsRouter(getState: () => Promise<ServerState | undefined>): Router;
-/** Create router for GET /usage (JSON) */
-export declare function createUsageRouter(getFreshState: () => Promise<ServerState | undefined>): Router;
+/** Create plugin for GET /health */
+export declare function createHealthPlugin(services: readonly string[], getState: () => ServerState | undefined, isShuttingDown: () => boolean): FastifyPluginCallbackZod;
+/** Create plugin for GET /metrics (Prometheus text exposition) */
+export declare function createMetricsPlugin(getState: () => Promise<ServerState | undefined>): FastifyPluginCallbackZod;
+/** Create plugin for GET /usage (JSON) */
+export declare function createUsagePlugin(getFreshState: () => Promise<ServerState | undefined>): FastifyPluginCallbackZod;
 //# sourceMappingURL=routes.d.ts.map

package/dist/server/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,oCAAoC;AACpC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,GACtC,MAAM,CAgBR;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,GAC/C,MAAM,CAgCR;AAED,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,GACpD,MAAM,CAkBR"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAS3D,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC,CAAC;AASF,oCAAoC;AACpC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,EACvC,cAAc,EAAE,MAAM,OAAO,GAC5B,wBAAwB,CAsC1B;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,GAC/C,wBAAwB,CA4C1B;AAED,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,GACpD,wBAAwB,CA6B1B"}

package/dist/server/routes.js

@@ -1,71 +1,122 @@
 /**
  * Route handlers for axusage serve mode.
  */
-import { Router } from "express";
 import packageJson from "../../package.json" with { type: "json" };
+import { ErrorResponseSchema, HealthResponseSchema, UsageResponseSchema, } from "../types/serve-api.js";
 import { formatPrometheusMetrics } from "../utils/format-prometheus-metrics.js";
 import { toJsonObject } from "../utils/format-service-usage.js";
-/** Create router for GET /health */
-export function createHealthRouter(services, getState) {
-    const router = Router();
-    router.get("/health", (_request, response) => {
-        const state = getState();
-        const healthy = state !== undefined && state.usage.length > 0;
-        response.status(healthy ? 200 : 503).json({
-            status: healthy ? "ok" : "degraded",
-            version: packageJson.version,
-            lastRefresh: state?.refreshedAt.toISOString(),
-            services,
-            errors: state?.errors ?? [],
+function formatServerError(error) {
+    if (error.status === undefined) {
+        return `${error.service}: ${error.message}`;
+    }
+    return `${error.service}: ${error.message} (HTTP ${String(error.status)})`;
+}
+/** Create plugin for GET /health */
+export function createHealthPlugin(services, getState, isShuttingDown) {
+    return function healthPlugin(fastify, _options, done) {
+        fastify.route({
+            method: "GET",
+            url: "/health",
+            config: { rateLimit: false },
+            schema: {
+                response: {
+                    200: HealthResponseSchema,
+                    503: HealthResponseSchema,
+                    500: ErrorResponseSchema,
+                },
+            },
+            handler: async (_request, reply) => {
+                if (isShuttingDown()) {
+                    const state = getState();
+                    return reply.code(503).send({
+                        status: "shutting_down",
+                        version: packageJson.version,
+                        lastRefresh: state?.refreshedAt.toISOString(),
+                        services: [...services],
+                        errors: state?.errors.map((error) => formatServerError(error)) ?? [],
+                    });
+                }
+                const state = getState();
+                const healthy = state !== undefined && state.usage.length > 0;
+                return reply.code(healthy ? 200 : 503).send({
+                    status: healthy ? "ok" : "degraded",
+                    version: packageJson.version,
+                    lastRefresh: state?.refreshedAt.toISOString(),
+                    services: [...services],
+                    errors: state?.errors.map((error) => formatServerError(error)) ?? [],
+                });
+            },
         });
-    });
-    return router;
+        done();
+    };
 }
-/** Create router for GET /metrics (Prometheus text exposition) */
-export function createMetricsRouter(getState) {
-    const router = Router();
-    // Memoize the rendered Prometheus text by the state snapshot's refreshedAt
-    // timestamp. Scrapes within the same cache window reuse the same Promise,
-    // avoiding recreating prom-client Registry/Gauge objects on each request.
-    // Rate is computed at refreshedAt so output is deterministic per snapshot,
-    // keeping the gauge coherent with the usage data it describes.
-    // Assignments happen synchronously (before any await) so require-atomic-updates
-    // is satisfied and concurrent scrapes naturally coalesce onto one render.
-    let memoFor;
-    let memoPromise = Promise.resolve("");
-    router.get("/metrics", async (_request, response) => {
-        const state = await getState();
-        const usage = state?.usage;
-        if (!usage || usage.length === 0) {
-            response.status(503).type("text/plain").send("No data yet\n");
-            return;
-        }
-        if (memoFor !== state.refreshedAt) {
-            memoFor = state.refreshedAt;
-            memoPromise = formatPrometheusMetrics(usage, state.refreshedAt.getTime());
-        }
-        const text = await memoPromise;
-        response
-            .status(200)
-            .type("text/plain; version=0.0.4; charset=utf-8")
-            .send(text);
-    });
-    return router;
+/** Create plugin for GET /metrics (Prometheus text exposition) */
+export function createMetricsPlugin(getState) {
+    return function metricsPlugin(fastify, _options, done) {
+        // Memoize the rendered Prometheus text by the state snapshot's refreshedAt
+        // timestamp. Scrapes within the same cache window reuse the same Promise,
+        // avoiding recreating prom-client Registry/Gauge objects on each request.
+        // Rate is computed at refreshedAt so output is deterministic per snapshot,
+        // keeping the gauge coherent with the usage data it describes.
+        // Assignments happen synchronously (before any await) so require-atomic-updates
+        // is satisfied and concurrent scrapes naturally coalesce onto one render.
+        let memoFor;
+        let memoPromise = Promise.resolve("");
+        fastify.route({
+            method: "GET",
+            url: "/metrics",
+            config: { rateLimit: false },
+            // No response schema: /metrics returns text/plain Prometheus exposition
+            // format for 200, which cannot be validated by a Zod object schema.
+            // Adding only a 503 schema would prevent Fastify's type provider from
+            // accepting the 200 text response. The 503 error returns JSON
+            // { error: "No data yet" } consistent with other error responses.
+            handler: async (_request, reply) => {
+                const state = await getState();
+                const usage = state?.usage;
+                if (!usage || usage.length === 0) {
+                    return reply.code(503).send({ error: "No data yet" });
+                }
+                const refreshedAtMs = state.refreshedAt.getTime();
+                if (memoFor !== refreshedAtMs) {
+                    memoFor = refreshedAtMs;
+                    memoPromise = formatPrometheusMetrics(usage, state.refreshedAt.getTime());
+                }
+                const text = await memoPromise;
+                return reply
+                    .code(200)
+                    .type("text/plain; version=0.0.4; charset=utf-8")
+                    .send(text);
+            },
+        });
+        done();
+    };
 }
-/** Create router for GET /usage (JSON) */
-export function createUsageRouter(getFreshState) {
-    const router = Router();
-    router.get("/usage", async (_request, response) => {
-        const state = await getFreshState();
-        const usage = state?.usage;
-        if (!usage || usage.length === 0) {
-            response.status(503).json({ error: "No data yet" });
-            return;
-        }
-        response
-            .status(200)
-            .json(usage.map((entry) => toJsonObject(entry, state.refreshedAt.getTime())));
-    });
-    return router;
+/** Create plugin for GET /usage (JSON) */
+export function createUsagePlugin(getFreshState) {
+    return function usagePlugin(fastify, _options, done) {
+        fastify.route({
+            method: "GET",
+            url: "/usage",
+            schema: {
+                response: {
+                    200: UsageResponseSchema,
+                    503: ErrorResponseSchema,
+                    500: ErrorResponseSchema,
+                },
+            },
+            handler: async (_request, reply) => {
+                const state = await getFreshState();
+                const usage = state?.usage;
+                if (!usage || usage.length === 0) {
+                    return reply.code(503).send({ error: "No data yet" });
+                }
+                return reply
+                    .code(200)
+                    .send(usage.map((entry) => toJsonObject(entry, state.refreshedAt.getTime())));
+            },
+        });
+        done();
+    };
 }
 //# sourceMappingURL=routes.js.map

package/dist/server/routes.js.map

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

package/dist/server/serve-logger.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyBaseLogger } from "fastify";
+export type ServeLogger = Pick<FastifyBaseLogger, "info" | "warn" | "error">;
+export declare function createConsoleServeLogger(): ServeLogger;
+export declare function createDeferredServeLogger(getLogger: () => FastifyBaseLogger | undefined): ServeLogger;
+//# sourceMappingURL=serve-logger.d.ts.map

package/dist/server/serve-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-logger.d.ts","sourceRoot":"","sources":["../../src/server/serve-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAE7E,wBAAgB,wBAAwB,IAAI,WAAW,CAwBtD;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,iBAAiB,GAAG,SAAS,GAC7C,WAAW,CAwDb"}

package/dist/server/serve-logger.js

@@ -0,0 +1,88 @@
+export function createConsoleServeLogger() {
+    return {
+        info(objectOrMessage, message) {
+            if (typeof objectOrMessage === "string") {
+                console.error(objectOrMessage);
+                return;
+            }
+            console.error(message ?? "", objectOrMessage);
+        },
+        warn(objectOrMessage, message) {
+            if (typeof objectOrMessage === "string") {
+                console.error(objectOrMessage);
+                return;
+            }
+            console.error(message ?? "", objectOrMessage);
+        },
+        error(objectOrMessage, message) {
+            if (typeof objectOrMessage === "string") {
+                console.error(objectOrMessage);
+                return;
+            }
+            console.error(message ?? "", objectOrMessage);
+        },
+    };
+}
+export function createDeferredServeLogger(getLogger) {
+    const fallback = createConsoleServeLogger();
+    return {
+        info(objectOrMessage, message) {
+            const logger = getLogger();
+            if (typeof objectOrMessage === "string") {
+                if (logger) {
+                    logger.info(objectOrMessage);
+                }
+                else {
+                    fallback.info(objectOrMessage);
+                }
+                return;
+            }
+            const resolvedMessage = message ?? "";
+            if (logger) {
+                logger.info(objectOrMessage, resolvedMessage);
+            }
+            else {
+                fallback.info(objectOrMessage, resolvedMessage);
+            }
+        },
+        warn(objectOrMessage, message) {
+            const logger = getLogger();
+            if (typeof objectOrMessage === "string") {
+                if (logger) {
+                    logger.warn(objectOrMessage);
+                }
+                else {
+                    fallback.warn(objectOrMessage);
+                }
+                return;
+            }
+            const resolvedMessage = message ?? "";
+            if (logger) {
+                logger.warn(objectOrMessage, resolvedMessage);
+            }
+            else {
+                fallback.warn(objectOrMessage, resolvedMessage);
+            }
+        },
+        error(objectOrMessage, message) {
+            const logger = getLogger();
+            if (typeof objectOrMessage === "string") {
+                if (logger) {
+                    logger.error(objectOrMessage);
+                }
+                else {
+                    fallback.error(objectOrMessage);
+                }
+                return;
+            }
+            const resolvedMessage = message ?? "";
+            if (logger) {
+                logger.error(objectOrMessage, resolvedMessage);
+            }
+            else {
+                fallback.error(objectOrMessage, resolvedMessage);
+            }
+        },
+    };
+}
+//# sourceMappingURL=serve-logger.js.map

package/dist/server/serve-logger.js.map

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

package/dist/server/server.d.ts

@@ -1,20 +1,27 @@
 /**
- * Express HTTP server for axusage metrics.
+ * Fastify HTTP server for axusage metrics.
  *
  * Designed for both CLI and library usage via factory pattern.
  */
-import { type Express, type Router } from "express";
+import { type FastifyInstance } from "fastify";
+import { type FastifyPluginCallbackZod } from "fastify-type-provider-zod";
 import type { ServeConfig } from "../config/serve-config.js";
-/** Server instance with lifecycle methods */
+/**
+ * Server instance with lifecycle methods.
+ *
+ * Extend the server by passing plugins to {@link createServer}, not by
+ * mutating `app` directly — `start()` rebuilds the Fastify instance after
+ * a `stop()` call, so any ad-hoc additions would be lost.
+ */
 type AxusageServer = {
-    /** The Express application instance */
-    readonly app: Express;
-    /** Start listening on the configured host:port */
+    /** The current Fastify application instance. Rebuilt after `stop()` + `start()`. */
+    readonly app: FastifyInstance;
+    /** Start listening on the configured host:port. Throws if already running. */
     start(): Promise<void>;
     /** Stop the server gracefully */
     stop(): Promise<void>;
 };
 /** Create an axusage server instance */
-export declare function createServer(config: Pick<ServeConfig, "port" | "host">, routers: Router[]): AxusageServer;
+export declare function createServer(config: Pick<ServeConfig, "port" | "host" | "logLevel" | "trustProxy">, plugins: FastifyPluginCallbackZod[]): AxusageServer;
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAgB,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,6CAA6C;AAC7C,KAAK,aAAa,GAAG;IACnB,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,iCAAiC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAsBF,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,EAC1C,OAAO,EAAE,MAAM,EAAE,GAChB,aAAa,CAmEf"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAgB,EAAqB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EACL,KAAK,wBAAwB,EAM9B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;GAMG;AACH,KAAK,aAAa,GAAG;IACnB,oFAAoF;IACpF,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,iCAAiC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAgFF,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC,EACtE,OAAO,EAAE,wBAAwB,EAAE,GAClC,aAAa,CA2Cf"}