@spinajs/telemetry 2.0.482

package/lib/mjs/policies/TelemetryTokenPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryTokenPolicy.js","sourceRoot":"","sources":["../../../src/policies/TelemetryTokenPolicy.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAgC,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;GAOG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,UAAU;IAA7C;;QAUK,uBAAkB,GAAG,iBAAiB,CAAC;IAsBnD,CAAC;IApBQ,SAAS,CAAC,OAAe,EAAE,SAAsB;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,GAAY;QAC/B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sDAAsD,IAAI,CAAC,kBAAkB,uCAAuC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACxJ,MAAM,IAAI,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gDAAgD,IAAI,CAAC,kBAAkB,uCAAuC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAClJ,MAAM,IAAI,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF,CAAA;AA9BW;IADT,MAAM,CAAC,UAAU,CAAC;8BACJ,GAAG;iDAAC;AAGT;IADT,MAAM,CAAC,sBAAsB,CAAC;;mDACP;AAGd;IADT,MAAM,CAAC,6BAA6B,CAAC;;mDACb;AARd,oBAAoB;IADhC,UAAU,CAAC,UAAU,CAAC;GACV,oBAAoB,CAgChC"}

package/lib/mjs/requestStats.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Serializable snapshot of {@link RequestStats}.
+ */
+export interface IRequestStatsSnapshot {
+    requests: number;
+    responses: number;
+    errors: number;
+    info: number;
+    success: number;
+    redirect: number;
+    client_error: number;
+    server_error: number;
+    total_time: number;
+    max_time: number;
+    min_time: number;
+    avg_time: number;
+    apdex_satisfied: number;
+    apdex_tolerated: number;
+    apdex_score: number;
+    req_rate: number;
+    err_rate: number;
+}
+/**
+ * Port of swagger-stats' `swsReqResStats` — accumulates request/response
+ * counters, response-time aggregates ( total / max / min / avg ), an Apdex
+ * score, and request/error rates over its lifetime.
+ *
+ * Pure and dependency-free; time is always passed in so it is deterministic.
+ */
+export declare class RequestStats {
+    /**
+     * Apdex satisfied-response threshold, in milliseconds. Responses up to
+     * `4 * threshold` are "tolerated".
+     */
+    readonly apdexThreshold: number;
+    requests: number;
+    responses: number;
+    errors: number;
+    info: number;
+    success: number;
+    redirect: number;
+    client_error: number;
+    server_error: number;
+    totalTime: number;
+    maxTime: number;
+    minTime: number;
+    avgTime: number;
+    apdexSatisfied: number;
+    apdexTolerated: number;
+    reqRate: number;
+    errRate: number;
+    constructor(apdexThreshold?: number);
+    /**
+     * Count an inbound request ( before the response is known ).
+     */
+    countRequest(): void;
+    /**
+     * Count a completed response, updating status-class counters, response-time
+     * aggregates and Apdex.
+     *
+     * @param statusCode - the HTTP status code of the response
+     * @param durationMs - the request duration in milliseconds
+     */
+    countResponse(statusCode: number, durationMs: number): void;
+    /**
+     * The current Apdex score: `(satisfied + tolerated/2) / responses`.
+     * Returns 0 when there are no responses yet.
+     */
+    apdex(): number;
+    /**
+     * Recompute request/error rates ( per second ) over an elapsed window.
+     *
+     * @param elapsedMs - the width of the window in milliseconds
+     */
+    updateRates(elapsedMs: number): void;
+    /**
+     * A plain-object snapshot of the current stats.
+     */
+    toJSON(): IRequestStatsSnapshot;
+}
+//# sourceMappingURL=requestStats.d.ts.map

package/lib/mjs/requestStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestStats.d.ts","sourceRoot":"","sources":["../../src/requestStats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IAErB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IAEjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,SAAgB,cAAc,EAAE,MAAM,CAAC;IAGhC,QAAQ,SAAK;IACb,SAAS,SAAK;IACd,MAAM,SAAK;IAGX,IAAI,SAAK;IACT,OAAO,SAAK;IACZ,QAAQ,SAAK;IACb,YAAY,SAAK;IACjB,YAAY,SAAK;IAGjB,SAAS,SAAK;IACd,OAAO,SAAK;IACZ,OAAO,SAAK;IACZ,OAAO,SAAK;IAGZ,cAAc,SAAK;IACnB,cAAc,SAAK;IAGnB,OAAO,SAAK;IACZ,OAAO,SAAK;gBAEP,cAAc,GAAE,MAAmC;IAI/D;;OAEG;IACI,YAAY,IAAI,IAAI;IAI3B;;;;;;OAMG;IACI,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA6BlE;;;OAGG;IACI,KAAK,IAAI,MAAM;IAKtB;;;;OAIG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAW3C;;OAEG;IACI,MAAM,IAAI,qBAAqB;CAyBvC"}

package/lib/mjs/requestStats.js

@@ -0,0 +1,130 @@
+const DEFAULT_APDEX_THRESHOLD_MS = 25;
+/**
+ * Port of swagger-stats' `swsReqResStats` — accumulates request/response
+ * counters, response-time aggregates ( total / max / min / avg ), an Apdex
+ * score, and request/error rates over its lifetime.
+ *
+ * Pure and dependency-free; time is always passed in so it is deterministic.
+ */
+export class RequestStats {
+    constructor(apdexThreshold = DEFAULT_APDEX_THRESHOLD_MS) {
+        // request/response counters
+        this.requests = 0;
+        this.responses = 0;
+        this.errors = 0;
+        // status-class counters
+        this.info = 0;
+        this.success = 0;
+        this.redirect = 0;
+        this.client_error = 0;
+        this.server_error = 0;
+        // response-time aggregates ( ms )
+        this.totalTime = 0;
+        this.maxTime = 0;
+        this.minTime = 0;
+        this.avgTime = 0;
+        // apdex accumulators
+        this.apdexSatisfied = 0;
+        this.apdexTolerated = 0;
+        // rates ( per second )
+        this.reqRate = 0;
+        this.errRate = 0;
+        this.apdexThreshold = apdexThreshold;
+    }
+    /**
+     * Count an inbound request ( before the response is known ).
+     */
+    countRequest() {
+        this.requests += 1;
+    }
+    /**
+     * Count a completed response, updating status-class counters, response-time
+     * aggregates and Apdex.
+     *
+     * @param statusCode - the HTTP status code of the response
+     * @param durationMs - the request duration in milliseconds
+     */
+    countResponse(statusCode, durationMs) {
+        this.responses += 1;
+        // status class counters
+        if (statusCode >= 100 && statusCode < 200)
+            this.info += 1;
+        else if (statusCode >= 200 && statusCode < 300)
+            this.success += 1;
+        else if (statusCode >= 300 && statusCode < 400)
+            this.redirect += 1;
+        else if (statusCode >= 400 && statusCode < 500)
+            this.client_error += 1;
+        else if (statusCode >= 500)
+            this.server_error += 1;
+        const isError = statusCode >= 400;
+        if (isError)
+            this.errors += 1;
+        // response-time aggregates
+        this.totalTime += durationMs;
+        if (durationMs > this.maxTime)
+            this.maxTime = durationMs;
+        if (this.minTime === 0 || durationMs < this.minTime)
+            this.minTime = durationMs;
+        this.avgTime = this.responses > 0 ? this.totalTime / this.responses : 0;
+        // Apdex — a "satisfactory" response is a non-error ( < 500 and not a
+        // client/server error ). swagger-stats treats any error ( 4xx/5xx ) as
+        // frustrating, so only 1xx/2xx/3xx responses can be satisfied/tolerated.
+        const satisfactory = !isError;
+        if (satisfactory) {
+            if (durationMs <= this.apdexThreshold)
+                this.apdexSatisfied += 1;
+            else if (durationMs <= 4 * this.apdexThreshold)
+                this.apdexTolerated += 1;
+        }
+    }
+    /**
+     * The current Apdex score: `(satisfied + tolerated/2) / responses`.
+     * Returns 0 when there are no responses yet.
+     */
+    apdex() {
+        if (this.responses === 0)
+            return 0;
+        return (this.apdexSatisfied + this.apdexTolerated / 2) / this.responses;
+    }
+    /**
+     * Recompute request/error rates ( per second ) over an elapsed window.
+     *
+     * @param elapsedMs - the width of the window in milliseconds
+     */
+    updateRates(elapsedMs) {
+        if (elapsedMs <= 0) {
+            this.reqRate = 0;
+            this.errRate = 0;
+            return;
+        }
+        const seconds = elapsedMs / 1000;
+        this.reqRate = this.requests / seconds;
+        this.errRate = this.errors / seconds;
+    }
+    /**
+     * A plain-object snapshot of the current stats.
+     */
+    toJSON() {
+        return {
+            requests: this.requests,
+            responses: this.responses,
+            errors: this.errors,
+            info: this.info,
+            success: this.success,
+            redirect: this.redirect,
+            client_error: this.client_error,
+            server_error: this.server_error,
+            total_time: this.totalTime,
+            max_time: this.maxTime,
+            min_time: this.minTime,
+            avg_time: this.avgTime,
+            apdex_satisfied: this.apdexSatisfied,
+            apdex_tolerated: this.apdexTolerated,
+            apdex_score: this.apdex(),
+            req_rate: this.reqRate,
+            err_rate: this.errRate,
+        };
+    }
+}
+//# sourceMappingURL=requestStats.js.map

package/lib/mjs/requestStats.js.map

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

package/lib/mjs/responses.d.ts

@@ -0,0 +1,23 @@
+import * as express from 'express';
+import { Response, HTTP_STATUS_CODE } from '@spinajs/http';
+import { Metrics } from './metrics.js';
+/**
+ * Writes prometheus exposition text with the registry's own content type.
+ * Bypasses the json/pug response pipeline entirely — a scrape endpoint has
+ * exactly one representation.
+ */
+export declare class PrometheusResponse extends Response {
+    protected metrics: Metrics;
+    constructor(metrics: Metrics);
+    execute(_req: express.Request, res: express.Response): Promise<void>;
+}
+/**
+ * HTTP 503. Needed because `Response.execute` overwrites any `StatusCode` given
+ * through `IResponseOptions` with the class's own `_errorCode`, so
+ * `new Ok( body, { StatusCode: 503 } )` silently returns 200.
+ */
+export declare class ServiceUnavailable<T = any> extends Response<T> {
+    protected _errorCode: HTTP_STATUS_CODE;
+    protected _template: string;
+}
+//# sourceMappingURL=responses.d.ts.map

package/lib/mjs/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAClC,SAAS,CAAC,OAAO,EAAE,OAAO;gBAAhB,OAAO,EAAE,OAAO;IAIzB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ;CAMlE;AAED;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAC1D,SAAS,CAAC,UAAU,mBAAwC;IAC5D,SAAS,CAAC,SAAS,SAAqB;CACzC"}

package/lib/mjs/responses.js

@@ -0,0 +1,30 @@
+import { Response, HTTP_STATUS_CODE } from '@spinajs/http';
+/**
+ * Writes prometheus exposition text with the registry's own content type.
+ * Bypasses the json/pug response pipeline entirely — a scrape endpoint has
+ * exactly one representation.
+ */
+export class PrometheusResponse extends Response {
+    constructor(metrics) {
+        super(null);
+        this.metrics = metrics;
+    }
+    async execute(_req, res) {
+        const result = await this.metrics.render();
+        res.contentType(this.metrics.contentType());
+        res.end(result);
+    }
+}
+/**
+ * HTTP 503. Needed because `Response.execute` overwrites any `StatusCode` given
+ * through `IResponseOptions` with the class's own `_errorCode`, so
+ * `new Ok( body, { StatusCode: 503 } )` silently returns 200.
+ */
+export class ServiceUnavailable extends Response {
+    constructor() {
+        super(...arguments);
+        this._errorCode = HTTP_STATUS_CODE.SERVICE_UNAVAILABLE;
+        this._template = 'serverError.pug';
+    }
+}
+//# sourceMappingURL=responses.js.map

package/lib/mjs/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/responses.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAI3D;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAsB,OAAgB;QACpC,KAAK,CAAC,IAAI,CAAC,CAAC;QADQ,YAAO,GAAP,OAAO,CAAS;IAEtC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAqB,EAAE,GAAqB;QAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAE3C,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5C,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAA4B,SAAQ,QAAW;IAA5D;;QACY,eAAU,GAAG,gBAAgB,CAAC,mBAAmB,CAAC;QAClD,cAAS,GAAG,iBAAiB,CAAC;IAC1C,CAAC;CAAA"}

package/lib/mjs/routeStats.d.ts

@@ -0,0 +1,43 @@
+import { IRequestStatsSnapshot } from './requestStats.js';
+/**
+ * One row of the per-route breakdown.
+ */
+export interface IRouteStatsEntry {
+    method: string;
+    route: string;
+    stats: IRequestStatsSnapshot;
+}
+/**
+ * Serializable snapshot of {@link RouteStats}.
+ */
+export interface IRouteStatsSnapshot {
+    /** True once the entry cap was hit and new routes stopped being tracked. */
+    truncated: boolean;
+    routes: IRouteStatsEntry[];
+}
+/**
+ * A bounded `method + route -> RequestStats` map.
+ *
+ * The bound is not optional. The telemetry middleware falls back to the raw
+ * request path when no route matched, so an unbounded map would grow one entry
+ * per distinct URL a 404-scanning bot tries.
+ */
+export declare class RouteStats {
+    readonly maxEntries: number;
+    readonly apdexThreshold: number;
+    private entries;
+    private truncated;
+    constructor(maxEntries: number, apdexThreshold: number);
+    /**
+     * True once at least one route was dropped because the cap was reached.
+     */
+    get Truncated(): boolean;
+    /**
+     * Record one completed response. A new method+route key is only created while
+     * under `maxEntries`; past that, known routes keep accumulating and unknown
+     * ones are dropped.
+     */
+    record(method: string, route: string, statusCode: number, durationMs: number): void;
+    toJSON(): IRouteStatsSnapshot;
+}
+//# sourceMappingURL=routeStats.d.ts.map

package/lib/mjs/routeStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeStats.d.ts","sourceRoot":"","sources":["../../src/routeStats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAgB,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAID;;;;;;GAMG;AACH,qBAAa,UAAU;aAIO,UAAU,EAAE,MAAM;aAAkB,cAAc,EAAE,MAAM;IAHtF,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,SAAS,CAAS;gBAEE,UAAU,EAAE,MAAM,EAAkB,cAAc,EAAE,MAAM;IAEtF;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAiBnF,MAAM,IAAI,mBAAmB;CAcrC"}

package/lib/mjs/routeStats.js

@@ -0,0 +1,55 @@
+import { RequestStats } from './requestStats.js';
+const KEY_SEPARATOR = ' ';
+/**
+ * A bounded `method + route -> RequestStats` map.
+ *
+ * The bound is not optional. The telemetry middleware falls back to the raw
+ * request path when no route matched, so an unbounded map would grow one entry
+ * per distinct URL a 404-scanning bot tries.
+ */
+export class RouteStats {
+    constructor(maxEntries, apdexThreshold) {
+        this.maxEntries = maxEntries;
+        this.apdexThreshold = apdexThreshold;
+        this.entries = new Map();
+        this.truncated = false;
+    }
+    /**
+     * True once at least one route was dropped because the cap was reached.
+     */
+    get Truncated() {
+        return this.truncated;
+    }
+    /**
+     * Record one completed response. A new method+route key is only created while
+     * under `maxEntries`; past that, known routes keep accumulating and unknown
+     * ones are dropped.
+     */
+    record(method, route, statusCode, durationMs) {
+        const key = `${method}${KEY_SEPARATOR}${route}`;
+        let stats = this.entries.get(key);
+        if (!stats) {
+            if (this.entries.size >= this.maxEntries) {
+                this.truncated = true;
+                return;
+            }
+            stats = new RequestStats(this.apdexThreshold);
+            this.entries.set(key, stats);
+        }
+        stats.countRequest();
+        stats.countResponse(statusCode, durationMs);
+    }
+    toJSON() {
+        const routes = [];
+        for (const [key, stats] of this.entries) {
+            const separator = key.indexOf(KEY_SEPARATOR);
+            routes.push({
+                method: key.substring(0, separator),
+                route: key.substring(separator + 1),
+                stats: stats.toJSON(),
+            });
+        }
+        return { truncated: this.truncated, routes };
+    }
+}
+//# sourceMappingURL=routeStats.js.map

package/lib/mjs/routeStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeStats.js","sourceRoot":"","sources":["../../src/routeStats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAoBxE,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IAIrB,YAA4B,UAAkB,EAAkB,cAAsB;QAA1D,eAAU,GAAV,UAAU,CAAQ;QAAkB,mBAAc,GAAd,cAAc,CAAQ;QAH9E,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC1C,cAAS,GAAG,KAAK,CAAC;IAE+D,CAAC;IAE1F;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAc,EAAE,KAAa,EAAE,UAAkB,EAAE,UAAkB;QACjF,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,aAAa,GAAG,KAAK,EAAE,CAAC;QAEhD,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,CAAC,YAAY,EAAE,CAAC;QACrB,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAEM,MAAM;QACX,MAAM,MAAM,GAAuB,EAAE,CAAC;QAEtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC;gBACnC,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;gBACnC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;CACF"}

package/lib/mjs/schemas/HealthResponse.schema.d.ts

@@ -0,0 +1,30 @@
+declare const HealthResponseSchema: {
+    type: string;
+    properties: {
+        status: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        startedAt: {
+            type: string;
+            description: string;
+        };
+        uptimeMs: {
+            type: string;
+        };
+        pid: {
+            type: string;
+        };
+        version: {
+            type: string;
+            description: string;
+        };
+        node: {
+            type: string;
+            description: string;
+        };
+    };
+};
+export default HealthResponseSchema;
+//# sourceMappingURL=HealthResponse.schema.d.ts.map

package/lib/mjs/schemas/HealthResponse.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthResponse.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/HealthResponse.schema.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUzB,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/lib/mjs/schemas/HealthResponse.schema.js

@@ -0,0 +1,13 @@
+const HealthResponseSchema = {
+    type: 'object',
+    properties: {
+        status: { type: 'string', enum: ['up'], description: 'Always "up" — this endpoint runs no checks' },
+        startedAt: { type: 'number', description: 'Process start, epoch ms' },
+        uptimeMs: { type: 'number' },
+        pid: { type: 'number' },
+        version: { type: 'string', description: 'telemetry.health.version; omitted when unset' },
+        node: { type: 'string', description: 'Node runtime version' },
+    },
+};
+export default HealthResponseSchema;
+//# sourceMappingURL=HealthResponse.schema.js.map

package/lib/mjs/schemas/HealthResponse.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthResponse.schema.js","sourceRoot":"","sources":["../../../src/schemas/HealthResponse.schema.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE;QACnG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACrE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;QACxF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;KAC9D;CACF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/lib/mjs/schemas/PerfResponse.schema.d.ts

@@ -0,0 +1,56 @@
+declare const PerfResponseSchema: {
+    type: string;
+    properties: {
+        truncated: {
+            type: string;
+            description: string;
+        };
+        spans: {
+            type: string;
+            description: string;
+            items: {
+                type: string;
+                properties: {
+                    name: {
+                        type: string;
+                        description: string;
+                    };
+                    count: {
+                        type: string;
+                    };
+                    totalMs: {
+                        type: string;
+                    };
+                    avgMs: {
+                        type: string;
+                    };
+                    maxMs: {
+                        type: string;
+                    };
+                };
+            };
+        };
+        events: {
+            type: string;
+            description: string;
+            items: {
+                type: string;
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    count: {
+                        type: string;
+                        description: string;
+                    };
+                    total: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+        };
+    };
+};
+export default PerfResponseSchema;
+//# sourceMappingURL=PerfResponse.schema.d.ts.map

package/lib/mjs/schemas/PerfResponse.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfResponse.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/PerfResponse.schema.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BvB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/lib/mjs/schemas/PerfResponse.schema.js

@@ -0,0 +1,34 @@
+const PerfResponseSchema = {
+    type: 'object',
+    properties: {
+        truncated: { type: 'boolean', description: 'True once the measurement-name cap was hit' },
+        spans: {
+            type: 'array',
+            description: 'Timed spans, slowest total first',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Measurement name, eg. orm.query' },
+                    count: { type: 'number' },
+                    totalMs: { type: 'number' },
+                    avgMs: { type: 'number' },
+                    maxMs: { type: 'number' },
+                },
+            },
+        },
+        events: {
+            type: 'array',
+            description: 'Counter and value events, largest total first',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    count: { type: 'number', description: 'Number of emissions' },
+                    total: { type: 'number', description: 'Summed value across emissions' },
+                },
+            },
+        },
+    },
+};
+export default PerfResponseSchema;
+//# sourceMappingURL=PerfResponse.schema.js.map

package/lib/mjs/schemas/PerfResponse.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfResponse.schema.js","sourceRoot":"","sources":["../../../src/schemas/PerfResponse.schema.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4CAA4C,EAAE;QACzF,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kCAAkC;YAC/C,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;oBACxE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;aACF;SACF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,+CAA+C;YAC5D,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;oBAC7D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;iBACxE;aACF;SACF;KACF;CACF,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/lib/mjs/schemas/ReadyResponse.schema.d.ts

@@ -0,0 +1,36 @@
+declare const ReadyResponseSchema: {
+    type: string;
+    properties: {
+        status: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        checks: {
+            type: string;
+            items: {
+                type: string;
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    status: {
+                        type: string;
+                        enum: string[];
+                    };
+                    durationMs: {
+                        type: string;
+                    };
+                    message: {
+                        type: string;
+                    };
+                    data: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+};
+export default ReadyResponseSchema;
+//# sourceMappingURL=ReadyResponse.schema.d.ts.map

package/lib/mjs/schemas/ReadyResponse.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadyResponse.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/ReadyResponse.schema.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBxB,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/lib/mjs/schemas/ReadyResponse.schema.js

@@ -0,0 +1,21 @@
+const ReadyResponseSchema = {
+    type: 'object',
+    properties: {
+        status: { type: 'string', enum: ['up', 'degraded', 'down'], description: 'Worst status across all checks' },
+        checks: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    status: { type: 'string', enum: ['up', 'degraded', 'down'] },
+                    durationMs: { type: 'number' },
+                    message: { type: 'string' },
+                    data: { type: 'object' },
+                },
+            },
+        },
+    },
+};
+export default ReadyResponseSchema;
+//# sourceMappingURL=ReadyResponse.schema.js.map

package/lib/mjs/schemas/ReadyResponse.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadyResponse.schema.js","sourceRoot":"","sources":["../../../src/schemas/ReadyResponse.schema.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAC3G,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;oBAC5D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzB;aACF;SACF;KACF;CACF,CAAC;AAEF,eAAe,mBAAmB,CAAC"}